Docker部署.NET应用通过ODBC连接SQL Server登录失败如何解决？

根因说明 #

报错核心是ODBC驱动解析连接串时未识别到database配置项，向SQL Server发起登录请求时传入了空的数据库名，被SQL Server拒绝。问题出在配置文件的语法错误和排版问题。

修复步骤 #

1. 修复Dockerfile语法错误 #

现有Dockerfile中添加微软源的命令被错误拆分换行，会导致ODBC驱动源未正确配置，驱动安装失效：

• 将换行的源配置命令合并为一行：

RUN curl https://packages.microsoft.com/config/debian/10/prod.list > /etc/apt/sources.list.d/mssql-release.list

• 建议将ENTRYPOINT指令移动到Dockerfile最后一行，避免后续维护时出现执行顺序逻辑错误。

2. 修复docker-compose.yml配置错误 #

这是导致本次报错的核心原因：

• 去除DATABASE_NAME配置中等号后的多余空格：
  原配置：- DATABASE_NAME= mydb
  修改为：- DATABASE_NAME=mydb
• 合并被换行拆分的连接串，保证ODBC驱动名完整、连接参数不被截断：
  原配置中Driver={ODBC Driver 17 for SQL和Server}被拆分为两行，会导致连接串解析失败，修改后配置为：

  - CONNECTION=Driver={ODBC Driver 17 for SQL Server};server=192.168.0.125\\sql2017,1433;database=mydb;uid=user;pwd=admin
  

  补充检查：如果你使用的是SQL Server默认实例，不需要加\\sql2017命名实例标识，直接写server=192.168.0.125,1433即可；如果确实是命名实例，需要确认SQL Server所在服务器的Browser服务已开启，且UDP 1434端口没有被防火墙拦截。

3. 验证连接有效性 #

修复配置后重新构建镜像、启动容器，进入容器执行以下命令测试连接是否正常：

sqlcmd -S 192.168.0.125\\sql2017,1433 -U user -P admin -d mydb -Q "SELECT @@VERSION"

• 如果命令正常返回SQL Server版本信息，说明驱动和连接参数配置正确，再检查应用代码读取连接串的逻辑是否存在取值错误即可。
• 如果命令报错，根据报错信息进一步定位：
  • 报驱动不存在：回到Dockerfile检查ODBC驱动安装步骤是否正确执行
  • 报连接超时：检查容器到192.168.0.125的网络是否连通，SQL Server 1433端口是否开放，防火墙是否放行容器网段的访问请求
  • 仍报数据库无法打开：确认mydb数据库真实存在，user账号拥有该数据库的访问权限。

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