Docker Compose部署Next.js应用连接外部SQL Server失败求助

一、自定义网络导致数据库不可达的问题 #

• 问题根因：自定义网络指定静态IP后，若IP段与宿主机网络冲突，或未配置NAT规则，容器将无法访问外部网络资源。
• 修复方案：
  • 放弃手动指定静态IP，直接使用Docker Compose默认的bridge网络，默认网络已配置NAT，支持容器访问外部。
  • 若必须使用自定义网络，仅需声明网络驱动为bridge，无需手动分配IP：

    networks:
      portalnet:
        driver: bridge
    

二、TLS连接失败的问题 #

本地运行正常但容器内报错，核心是容器环境与本地的TLS信任机制不一致：

• 问题根因：SQL Server默认要求加密连接，容器内的Node.js环境未信任SQL Server证书（尤其是自签名证书）。
• 修复方案：
  1. 调整Prisma连接字符串，添加TLS兼容参数：

     sqlserver://SERVER_IP_ADD:1433;database=YOUR_DB_NAME;user=YOUR_USER;password=YOUR_PWD;encrypt=true;trustServerCertificate=true
     

     （trustServerCertificate=true用于跳过自签名证书的验证，生产环境建议使用正规CA签发的证书并移除该参数）
  2. 确保Docker镜像安装了证书依赖：
     • 若使用Alpine镜像，在Dockerfile中添加：

       RUN apk add --no-cache ca-certificates
       

     • 若使用Debian/Ubuntu镜像，在Dockerfile中添加：

       RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
       

三、额外验证项 #

• 测试宿主机与SQL Server的连通性：执行telnet SERVER_IP_ADD 1433确认端口开放。
• 检查SQL Server配置：确保TCP/IP协议已启用，且防火墙允许1433端口的外部入站请求。
• 核对容器环境变量：确认连接字符串已正确传入容器，无拼写错误。

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