使用Cypress测试MSSQL数据库时出现‘sa登录失败’错误怎么办？

以下是针对问题的具体排查步骤：

• 核对连接字符串细节
  确保Cypress配置（如cypress.json）里的连接参数和SSMS登录时完全一致：

  • 服务器地址：默认实例用localhost或127.0.0.1，命名实例（如SQLEXPRESS）必须写localhost\SQLEXPRESS，不能省略实例名
  • 端口号：检查SQL Server配置管理器中TCP/IP协议的端口（默认1433，命名实例可能是随机端口），连接字符串需明确指定对应端口
  • 密码转义：如果sa密码包含特殊字符（如"、\），在JSON配置里必须转义，比如密码pass"123要写成"pass\"123"

• 检查数据库连接插件配置
  若使用mssql库连接，确保plugins/index.js里的连接选项正确：

  const sql = require('mssql');
  module.exports = (on, config) => {
    on('task', {
      async queryDb(query) {
        try {
          await sql.connect({
            user: 'sa',
            password: '你的密码',
            server: 'localhost',
            database: '目标库名',
            port: 1433,
            options: {
              encrypt: false, // 本地环境通常无需加密，强制开启会导致连接失败
              trustServerCertificate: true
            }
          });
          const result = await sql.query(query);
          return result.recordset;
        } catch (err) {
          console.error('数据库连接完整错误:', err); // 打印细节，获取更具体失败原因
          throw err;
        } finally {
          await sql.close();
        }
      }
    });
    return config;
  };
  

  重点关注encrypt选项，本地SQL Server默认未启用加密，开启后会触发登录失败。同时在catch块打印完整错误对象，定位具体问题。

• 验证sa账号状态
  在SSMS中右键安全性 > 登录名 > sa，选择属性：

  • 切换到「状态」页，确保「登录」选项为「启用」
  • 确认「是否锁定」为「否」，若账号被锁定，解锁后再测试

• 检查防火墙与端口可用性

  • 临时关闭本地Windows防火墙，测试是否能连接（排除防火墙拦截1433端口的可能）
  • 若无法关闭防火墙，在防火墙高级设置中添加SQL Server程序或1433端口的入站允许规则

• 确认SQL Server实例TCP/IP配置
  打开SQL Server配置管理器：

  • 展开SQL Server网络配置 > MSSQLSERVER的协议，确保TCP/IP已启用
  • 右键TCP/IP选择属性，切换到「IP地址」页，拉至底部「IPAll」，确认「TCP端口」与连接时使用的端口一致（如1433）
  • 重启SQL Server服务（MSSQLSERVER）使配置生效

• 排查Cypress运行环境权限
  尝试用管理员权限启动Cypress（右键Cypress快捷方式，选择「以管理员身份运行」），部分环境下权限不足可能导致SQL连接异常

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