Sails.js中ORM钩子加载失败问题排查请求

架构老林

2026-5-21

排查Sails.js数据库连接失败问题

我从昨天开始尝试配置Sails.js的数据库连接，但始终无法正常运行，不清楚问题出在哪里。以下是connections.js中的代码：
module.exports.connections = { 
  mysql: { 
    adapter: 'sails-mysql', 
    host: 'localhost', 
    user: 'root', //optional 
    password: 'root', //optional 
    database: 'mysql' //optional 
  } 
}
以及models.js中的代码：
module.exports.models = { 
  connection:'mysql', 
  migrate:'alter' 
}

我帮你梳理几个最可能导致连接失败的原因，你可以逐一排查：

先确认sails-mysql适配器已安装：很多新手容易漏掉这一步——你得确保这个依赖已经被添加到项目里。在项目根目录执行npm install sails-mysql --save，安装完成后重启Sails服务再试。
检查MySQL服务是否在运行：如果本地MySQL没启动，肯定连不上。Windows用户可以去「服务」列表里找MySQL确认状态；Mac/Linux用户在终端执行mysql.server status查看，没启动的话用mysql.server start开启。
验证数据库连接参数的正确性：
- 你配置的database是mysql，这是MySQL自带的系统数据库，不建议用来存业务数据。先手动创建一个新数据库（比如my_sails_db），然后把database字段改成这个新库名。
- 确认root用户的密码确实是root——有时候安装MySQL时会设置不同的初始密码，或者你后来修改过。可以用MySQL命令行/客户端试试root/root能不能登录本地MySQL，登录失败的话先修正密码。
检查用户权限：确保root用户允许从localhost登录。在MySQL命令行执行SELECT user, host FROM mysql.user;，看看root对应的host是否包含localhost或127.0.0.1。如果没有，需要给root授权：GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'root';，然后执行FLUSH PRIVILEGES;生效。
端口配置是否正确：默认MySQL端口是3306，如果你的MySQL修改过端口，需要在connections.js的mysql配置里加上port: 你的端口号（比如port: 3307）。
查看Sails的错误日志：启动Sails时如果连接失败，控制台会输出具体错误信息（比如「Access denied」「Can't connect to MySQL server」），这些信息是定位问题的关键。如果控制台日志不够详细，去项目的.tmp/logs目录看完整日志文件。

内容的提问来源于stack exchange，提问作者faraz