SailsJS连接Azure MS SQL数据库遇ORM加载错误，求解决指导

错误原因 #

你遇到的Consistency violation: the adapter for datastore 'default' does not have an 'identity' property错误，是因为直接使用mssql npm包不符合Sails Waterline ORM的适配器规范——Waterline要求适配器必须包含identity属性，而原生mssql包并非为Waterline设计。

解决步骤 #

1. 安装Waterline兼容的MS SQL适配器 #

使用Sails官方维护的SQL Server适配器，确保与最新版本Sails兼容：

npm install @sailshq/sqlserver --save

2. 配置Datastore #

修改config/datastores.js文件，替换默认配置为Azure SQL的连接信息：

module.exports.datastores = {
  default: {
    adapter: '@sailshq/sqlserver',
    // 方式一：使用连接字符串
    url: 'mssql://<用户名>:<密码>@<Azure服务器名>.database.windows.net:1433/<数据库名>?encrypt=true',
    // 方式二：分参数配置（更直观）
    // server: '<Azure服务器名>.database.windows.net',
    // user: '<用户名>@<Azure服务器名>',
    // password: '<密码>',
    // database: '<数据库名>',
    // options: {
    //   encrypt: true, // Azure SQL强制要求加密连接
    //   trustServerCertificate: false // 禁用证书信任，保障连接安全
    // }
  }
};

注意：

• 替换尖括号内的内容为你的Azure SQL实际凭据与信息
• Azure SQL用户名格式通常为用户名@服务器名
• 必须开启encrypt: true，否则无法建立连接

3. 验证模型配置 #

确保你的模型（位于api/models/目录下）默认使用default数据源，示例：

module.exports = {
  datastore: 'default',
  attributes: {
    // 模型字段定义
  }
};

若未显式指定datastore，Sails会自动使用default，此步骤可省略。

4. 排查额外问题 #

• Azure SQL防火墙设置：登录Azure门户，确认服务器防火墙允许当前开发机器的IP地址访问
• 版本兼容性：核对@sailshq/sqlserver版本与你安装的最新Sails版本是否匹配（可查看包的README确认支持范围）
• 参数校验：检查服务器地址、端口（默认1433）、用户名和密码是否存在拼写错误

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