Made better error messages for when we have trouble connecting to a database. Closes #227

lib/dialects/mysql/connector-manager.js

@@ -241,7 +241,9 @@ module.exports = (function() {
   }
 
   var connect = function(done, config) {
+    var emitter = new (require('events').EventEmitter)()
     config = config || this.config
+
     var connection = mysql.createConnection({
       host: config.host,
       port: config.port,
@@ -250,6 +252,23 @@ module.exports = (function() {
       database: config.database,
       timezone: 'Z'
     })
+
+    connection.connect(function(err) {
+      if (err) {
+        switch(err.code) {
+        case 'ECONNREFUSED':
+        case 'ER_ACCESS_DENIED_ERROR':
+          emitter.emit('error', new Error("Failed to authenticate for MySQL. Please double check your settings."))
+          break
+        case 'ENOTFOUND':
+        case 'EHOSTUNREACH':
+        case 'EINVAL':
+          emitter.emit('error', new Error("Failed to find MySQL server. Please double check your settings."))
+          break
+        }
+      }
+    })
+
     connection.query("SET time_zone = '+0:00'");
     // client.setMaxListeners(self.maxConcurrentQueries)
     this.isConnecting = false

lib/dialects/postgres/connector-manager.js

@@ -27,7 +27,8 @@ module.exports = (function() {
 
   ConnectorManager.prototype.query = function(sql, callee, options) {
     var self = this
-    if (this.client == null) {
+
+    if (this.client === null) {
       this.connect()
     }
 
@@ -68,7 +69,18 @@ module.exports = (function() {
       self.isConnecting = false
 
       if (!!err) {
+        switch(err.code) {
+        case 'ECONNREFUSED':
+          emitter.emit('error', new Error("Failed to authenticate for PostgresSQL. Please double check your settings."))
+          break
+        case 'ENOTFOUND':
+        case 'EHOSTUNREACH':
+        case 'EINVAL':
+          emitter.emit('error', new Error("Failed to find PostgresSQL server. Please double check your settings."))
+          break
+        default:
           emitter.emit('error', err)
+        }
       } else if (client) {
         client.query("SET TIME ZONE 'UTC'")
           .on('end', function() {

lib/dialects/sqlite/connector-manager.js

@@ -5,17 +5,34 @@ var Utils   = require("../../utils")
 module.exports = (function() {
   var ConnectorManager = function(sequelize) {
     this.sequelize = sequelize
-    this.database  = db = new sqlite3.Database(sequelize.options.storage || ':memory:', function(err) {
-      if(!err && sequelize.options.foreignKeys !== false) {
+  }
+
+  Utils._.extend(ConnectorManager.prototype, require("../connector-manager").prototype)
+
+  ConnectorManager.prototype.connect = function() {
+    var emitter = new (require('events').EventEmitter)()
+      , self = this
+
+    this.database = db = new sqlite3.Database(self.sequelize.options.storage || ':memory:', function(err) {
+      if (err) {
+        if (err.code === "SQLITE_CANTOPEN") {
+          emitter.emit('error', new Error("Failed to find SQL server. Please double check your settings."))
+        }
+      }
+
+      if(!err && self.sequelize.options.foreignKeys !== false) {
         // Make it possible to define and use foreign key constraints unless
         // explicitly disallowed. It's still opt-in per relation
         db.run('PRAGMA FOREIGN_KEYS=ON')
       }
     })
   }
-  Utils._.extend(ConnectorManager.prototype, require("../connector-manager").prototype)
 
   ConnectorManager.prototype.query = function(sql, callee, options) {
+    if (!this.database) {
+      this.connect()
+    }
+
     return new Query(this.database, this.sequelize, callee, options).run(sql)
   }
 

spec/configuration.spec.js

@@ -2,6 +2,7 @@ if(typeof require === 'function') {
   const buster           = require("buster")
     , CustomEventEmitter = require("../lib/emitters/custom-event-emitter")
     , Helpers            = require('./buster-helpers')
+    , config             = require(__dirname + "/config/config")
     , dialect            = Helpers.getTestDialect()
 }
 
@@ -11,6 +12,86 @@ buster.testRunner.timeout = 1000
 var Sequelize = require(__dirname + '/../index')
 
 describe(Helpers.getTestDialectTeaser("Configuration"), function() {
+  describe('Connections problems should fail with a nice message', function() {
+    it('should give us an error for not having the correct server details', function(done) {
+      var domain
+
+      try {
+        domain = require('domain')
+      } catch (err) {
+        console.log('WARNING: Configuration specs requires Node version >= 0.8')
+        expect('').toEqual('') // Silence Buster!
+        done()
+      }
+
+      var d = domain.create()
+
+      var sequelize = new Sequelize(config[dialect].database, config[dialect].username, config[dialect].password, {storage: '/path/to/no/where/land', logging: false, host: '0.0.0.1', port: config[dialect].port, dialect: dialect})
+      d.add(sequelize.query)
+
+      d.on('error', function(err){
+        d.remove(sequelize.query)
+        var msg = 'Failed to find SQL server. Please double check your settings.'
+        if (dialect === "postgres" || dialect === "postgres-native") {
+          msg = 'Failed to find PostgresSQL server. Please double check your settings.'
+        }
+        else if (dialect === "mysql") {
+          msg = 'Failed to find MySQL server. Please double check your settings.'
+        }
+
+        expect(err.message).toEqual(msg)
+        done()
+      })
+
+      d.run(function(){
+        sequelize.query('select 1 as hello')
+        .success(function(){})
+      })
+    })
+
+    it('should give us an error for not having the correct login information', function(done) {
+      if (dialect !== "postgres" && dialect !== "postgres-native" && dialect !== "mysql") {
+        // This dialect doesn't support incorrect login information
+        expect('').toEqual('') // Silence Buster
+        return done()
+      }
+
+      var domain
+
+      try {
+        domain = require('domain')
+      } catch (err) {
+        console.log('WARNING: Configuration specs requires Node version >= 0.8')
+        expect('').toEqual('') // Silence Buster!
+        done()
+      }
+
+      var d = domain.create()
+
+      var sequelize = new Sequelize(config[dialect].database, config[dialect].username, 'fakepass123', {logging: false, host: config[dialect].host, port: 1, dialect: dialect})
+      d.add(sequelize.query)
+
+      d.on('error', function(err){
+        d.remove(sequelize.query)
+        var msg = 'Failed to authenticate for SQL. Please double check your settings.'
+        if (dialect === "postgres" || dialect === "postgres-native") {
+          msg = 'Failed to authenticate for PostgresSQL. Please double check your settings.'
+        }
+        else if (dialect === "mysql") {
+          msg = 'Failed to authenticate for MySQL. Please double check your settings.'
+        }
+
+        expect(err.message).toEqual(msg)
+        done()
+      })
+
+      d.run(function(){
+        sequelize.query('select 1 as hello')
+        .success(function(){})
+      })
+    })
+  })
+
   describe('Instantiation with a URL string', function() {
     it('should accept username, password, host, port, and database', function() {
       var sequelize = new Sequelize('mysql://user:pass@example.com:9821/dbname')