Node.js容器无法连接SQL Server容器，请求排查解决

1. 检查Docker Compose网络配置 #

• 确保两个容器处于同一Docker网络（Compose默认会为项目创建专属网络，手动指定网络时需确认配置一致）。可通过docker inspect <compose-project-name>_default命令查看网络内的容器成员。
• 数据库连接地址禁止使用localhost/127.0.0.1，必须使用Compose配置中db服务的服务名（例如db）作为主机地址——容器间通过服务名进行DNS解析。

2. 验证数据库连接参数 #

核对dbconfig.js中的配置项，确保与SQL Server容器的初始化配置匹配：

// 示例正确配置
module.exports = {
  user: 'sa',
  password: 'YourStrong!Passw0rd', // 需与DB容器环境变量SA_PASSWORD一致
  server: 'db', // 此处必须为Compose中db服务的名称
  database: 'YourTargetDB', // 需与SQL Server初始化的库名一致
  port: 1433, // 容器内SQL Server默认端口，即使Compose映射了外部端口，内部仍用1433
  options: {
    encrypt: true, // SQL Server强制要求的加密配置
    trustServerCertificate: true // 本地开发场景可开启，避免证书验证错误
  }
};

3. 确保SQL Server容器完全就绪 #

SQL Server启动初始化需要时间，Node.js应用可能在数据库未就绪时发起连接导致失败，可通过两种方式解决：

• 在Compose中为db服务添加健康检查，让web服务等待数据库就绪后再启动：

# docker-compose.yml示例配置
services:
  db:
    build: ./db
    ports:
      - "1433:1433"
    environment:
      SA_PASSWORD: "YourStrong!Passw0rd"
      ACCEPT_EULA: "Y"
    healthcheck:
      test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P YourStrong!Passw0rd -Q 'SELECT 1' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
  web:
    build: ./web
    ports:
      - "3000:3000"
    depends_on:
      db:
        condition: service_healthy

• 在Node.js代码中添加自动重连逻辑，避免首次连接失败导致应用崩溃：

// server.js中连接数据库的逻辑
const sql = require('mssql');
const config = require('./dbconfig');

async function connectDB() {
  try {
    await sql.connect(config);
    console.log('数据库连接成功');
  } catch (err) {
    console.error('连接失败，3秒后重试:', err.message);
    setTimeout(connectDB, 3000);
  }
}

connectDB();

4. 测试容器间网络连通性 #

进入Node.js容器，直接测试与SQL Server容器的网络连通性：

# 进入web容器（替换为你的容器名称）
docker exec -it <web-container-name> sh

# 测试能否解析db服务名（若容器无ping工具，可先安装：apt-get update && apt-get install iputils-ping）
ping db

# 测试1433端口是否可访问（安装telnet：apt-get install telnet）
telnet db 1433

如果ping不通，说明网络配置存在问题；telnet连接失败，说明数据库端口未开放或服务未正常启动。

5. 通过日志定位具体错误 #

• 查看Node.js应用日志：docker logs <web-container-name>，提取具体的连接错误信息（如认证失败、主机不可达、超时等）。
• 查看SQL Server容器日志：docker logs <db-container-name>，确认服务是否正常启动，有无初始化报错。

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