Docker部署EF Core 7 WebApi时PostgreSQL列Null异常排查

以下是针对你遇到的问题的可能原因及排查方向：

• 实体类可空性定义不匹配
  检查你的Member实体中Code字段的定义：如果是public string Code { get; set; }而非public string? Code { get; set; }，即使迁移脚本设了nullable: true，EF Core也会将其视为非可空类型。本地环境可能因项目Nullable上下文未启用（如项目文件<Nullable>设为disable）而兼容，但Docker发布版本严格执行了可空检查，导致null值转换失败。

• Npgsql驱动版本不一致
  Docker容器中安装的Npgsql.EntityFrameworkCore.PostgreSQL驱动版本可能和本地不同。部分旧版本驱动对PostgreSQL text类型的null值映射存在bug，升级到EF Core 7对应的最新稳定版驱动，确保Docker构建时拉取的包版本与本地一致。

• 数据库列实际可空性不符
  进入PostgreSQL容器执行SQL：

  SELECT is_nullable FROM information_schema.columns WHERE table_name = 'members' AND column_name = 'code';
  

  确认该列实际is_nullable值为YES。可能迁移脚本执行失败、或手动修改过数据库结构，导致列的可空性与迁移脚本定义不一致。

• EF Core查询配置差异
  对比本地与Docker环境的EF Core查询配置：

  • 检查是否在Docker环境中启用了QuerySplittingBehavior.SplitQuery等特殊查询模式，这类配置可能改变null值处理逻辑；
  • 查看是否在Docker的API中使用了AsNoTracking()无跟踪查询，部分场景下无跟踪查询对null值的转换逻辑与跟踪查询不同，可临时改为AsTracking()测试是否解决问题。

• 连接字符串参数差异
  检查本地与Docker容器的数据库连接字符串，是否存在Enlist=true、TrustServerCertificate=true等差异参数，部分参数可能影响Npgsql驱动读取null值的行为。

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