推荐用 mcr.microsoft.com/dotnet/aspnet:8.0 镜像，挂载宿主机 bin/debug/net8.0 到 /app，working_dir 设为 /app 并 command 运行 dll；连接其他服务用服务名（如 postgres）而非 localhost。
docker-compose.yml 中如何定义 C# 项目服务（.NET SDK vs 运行时镜像）
本地开发用 docker-compose.yml 启动 C# 项目，关键不是“能不能跑”，而是“改代码要不要重构建”。直接用 mcr.microsoft.com/dotnet/sdk:8.0 镜像做运行环境，会导致每次 dotnet run 都触发完整编译，浪费时间且容器内路径和宿主机不一致。
推荐做法：宿主机编译 + 容器仅运行。把 bin/Debug/net8.0 挂载进基于 mcr.microsoft.com/dotnet/aspnet:8.0 的轻量镜像里，跳过容器内编译环节。
- 服务定义中用
image: mcr.microsoft.com/dotnet/aspnet:8.0，不要用sdk镜像 -
volumes挂载必须包含./bin/Debug/net8.0:/app（路径需与项目输出一致） -
working_dir: /app和command: dotnet YourApp.dll要配对，否则找不到入口程序 - 确保
.csproj中有<targetframework>net8.0</targetframework>，否则挂载的 DLL 可能版本不匹配
如何让 C# 服务自动重建并热重载（dotnet watch）
官方 dotnet watch 在容器里默认不生效，因为文件系统事件（inotify）在挂载卷上受限，且容器内缺少开发工具链。强行在 sdk 镜像里跑 dotnet watch 会拖慢启动、增大镜像、且 Windows/macOS 下行为不一致。
更可靠的做法：宿主机运行 dotnet watch，容器只负责承载 HTTP 服务和依赖（如数据库、Redis）。通过端口映射让浏览器访问容器 IP 或 localhost。
- 开发时不用在
docker-compose.yml里启用dotnet watch，它属于宿主机 dev 工具链 - 在宿主机执行
dotnet watch --project ./YourApp.csproj，它会监听源码变化并自动重启进程 - 容器服务的
ports仍要暴露（如"5000:5000"），但应用本身由宿主机进程提供，不是容器内运行 - 若坚持容器内热重载，需加
sysfs:ro挂载和--privileged（不推荐，破坏隔离性）
多容器间通信：C# 应用如何连接 PostgreSQL/Redis 容器
C# 应用在容器里连其他服务，不能写 localhost:5432——那是它自己的回环地址。Docker Compose 默认为每个服务创建 DNS 记录，服务名即主机名。
例如 postgres 服务定义后，C# 代码里连接字符串应写 Host=postgres;Port=5432;...，而不是 localhost 或 127.0.0.1。这个解析由 Docker 内置 DNS 自动完成，无需额外配置。
- 检查
docker-compose.yml中服务名是否全小写、无下划线（如db可，my-db也可，但 C# 里要用my-db作 Host） -
depends_on只控制启动顺序，不保证服务已就绪；C# 启动时需实现重试逻辑或用dotnet ef database update等预检 - PostgreSQL 容器默认不接受外部连接，需确认
POSTGRES_HOST_AUTH_METHOD=trust或配好pg_hba.conf - Redis 若用
redis:alpine，注意其默认禁用 TCP keepalive，高并发下可能断连，C# 客户端需设ConnectTimeout和SyncTimeout
常见 docker-compose.yml 错误导致 C# 应用启动失败
很多问题不是代码错，而是 compose 配置和 .NET 运行时特性没对齐。最典型的几个坑：
-
build:和image:同时存在且冲突——如果指定了image，build会被忽略；开发阶段建议删掉image，只留build和context -
environment里写ASPNETCORE_URLS=http://+:80，但没配ports映射，导致宿主机无法访问 -
volumes挂载路径权限不对，Linux 容器里/app目录属主是 root，而 .NET 运行时以非 root 用户（如app）启动，会报Access to the path '/app' is denied - Windows 上用 WSL2 后台时，
docker-compose.yml里的路径分隔符写成\（如./bin\Debug\net8.0），实际需统一用/
调试时优先 docker compose up -d && docker compose logs -f your-service-name，错误通常在第一屏日志里，比如 Could not load file or assembly 'Microsoft.AspNetCore.Mvc.Core' 就是镜像版本和项目 TargetFramework 不匹配。
