ASP.NET Core Docker容器中MongoDB连接字符串缺失异常修复求助

核心原因 #

Docker容器内的localhost指向容器自身，而非宿主机。你的BooksApiApp容器尝试访问localhost:27017，但容器内部并没有MongoDB服务，导致连接字符串无法正常生效，最终抛出System.ArgumentNullException。

具体修复步骤 #

1. 修改MongoDB连接字符串 #

将配置文件里的MongoDB连接字符串从：

"MongoDb": "mongodb://localhost:27017"

替换为：

"MongoDb": "mongodb://mongodb:27017"

这里的mongodb是你Docker Compose中MongoDB服务的名称，Docker会在自定义网络mybridgenetwork中自动将这个名称解析为MongoDB容器的IP地址。

2. 确认配置文件已正确复制到容器 #

检查BooksApi/Dockerfile，确保appsettings.json这类配置文件被正确复制到容器的工作目录中。示例Dockerfile关键片段：

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["BooksApi/BooksApi.csproj", "BooksApi/"]
RUN dotnet restore "BooksApi/BooksApi.csproj"
COPY . .
WORKDIR "/src/BooksApi"
RUN dotnet build "BooksApi.csproj" -c Release -o /app/build

# 发布阶段
FROM build AS publish
RUN dotnet publish "BooksApi.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段
FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "BooksApi.dll"]

保证appsettings.json在项目目录中，且能通过COPY . .步骤被复制到容器内。

3. 可选：用环境变量覆盖连接字符串（更灵活） #

如果不想修改配置文件，可以在docker-compose.yml的BooksApiApp服务中添加环境变量，直接覆盖连接字符串：

services:
  BooksApiApp:
    # 原有配置保持不变
    environment:
      - ConnectionStrings__MongoDb=mongodb://mongodb:27017

ASP.NET Core会自动识别这种格式的环境变量，覆盖配置文件中的对应值。

4. 验证网络连通性 #

重启容器后，可进入BooksApiApp容器测试网络是否正常：

docker exec -it booksapiApp ping mongodb

如果能ping通，说明网络解析正常。

额外注意点 #

• depends_on仅保证mongodb容器先启动，不确保MongoDB服务完全就绪。如果需要等待服务启动完成，可添加wait-for-it.sh这类脚本，避免API服务在MongoDB未就绪时启动导致的连接失败。
• 检查ASP.NET Core代码读取连接字符串的逻辑，确保是通过Configuration.GetConnectionString("MongoDb")正确读取，而非硬编码或其他错误方式。

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