Docker中ABP.io搭建的API无法连接SQL Server问题排查

1. 修正Dockerfile的多阶段构建逻辑 #

你的Dockerfile存在构建流程错误：build阶段未执行实际编译操作，且final阶段错误覆盖了发布文件。替换为正确的多阶段构建配置：

# 构建阶段：编译并发布项目
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
# 复制项目文件并还原依赖（利用Docker缓存优化构建速度）
COPY ["MyApi/MyApi.csproj", "MyApi/"]
RUN dotnet restore "MyApi/MyApi.csproj"
# 复制全部代码并发布
COPY . .
WORKDIR "/src/MyApi"
RUN dotnet publish "MyApi.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段：基于ASP.NET Runtime镜像运行发布产物
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyApi.dll"]

2. 修改数据库连接字符串，禁用注册表查找 #

日志中的NullReferenceException来自SQL Client在Linux容器中尝试读取Windows注册表（Linux无注册表机制），需在连接字符串中添加DisableRegistryLookup=True禁用该行为：

Server=sqlserver,1433;Database=MyDatabase;User ID=sa;pwd=<你的密码>;TrustServerCertificate=True;DisableRegistryLookup=True

确保该连接字符串配置在appsettings.Docker.json或对应Docker环境的配置文件中，且ABP框架正确加载了该环境配置。

3. 补充：确保SQL Server就绪后再启动API #

depends_on仅保证启动顺序，不等待SQL Server完全就绪。可在API启动时添加等待逻辑，比如在Program.cs中加入：

using Microsoft.Data.SqlClient;

var builder = WebApplication.CreateBuilder(args);

// 添加等待SQL Server就绪的逻辑
var connectionString = builder.Configuration.GetConnectionString("Default");
var retryCount = 5;
while (retryCount > 0)
{
    try
    {
        using var conn = new SqlConnection(connectionString);
        await conn.OpenAsync();
        break;
    }
    catch
    {
        retryCount--;
        await Task.Delay(2000);
    }
}

// 后续ABP初始化代码...

验证步骤 #

1. 重新构建API镜像：docker-compose build my-api
2. 重启服务：docker-compose up -d
3. 查看API日志：docker logs my-api，确认无NullReferenceException且API正常启动

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