EF Core 7生产环境空值异常及跨环境运行一致性问题

使用.NET Core + EF Core 7开发对接PostgreSQL/MySQL的控制台应用，本地Windows开发阶段EF Core查询无异常，但发布到Linux生产环境后，频繁抛出System.ArgumentNullException: Value cannot be null. (Parameter 'source')异常。

示例查询代码：

var projects = dbContext.Projects
    .Where(w => w.Year > 2022)
    .Select(s => new {s.Id, s.Name})
    .ToList();

异常详情（Linux环境报错仍显示本地代码路径）：

Unhandled exception. System.ArgumentNullException: Value cannot be null. (Parameter 'source')
   at System.ArgumentNullException.Throw(String)
   at System.Linq.Queryable.Where[TSource](IQueryable`1 source, Expression`1 predicate)
   at Program.<Main>$(String[]) in C:\Users\myname\RiderProjects\ETL\ProjectTransaction\Program.cs:line 62

当前临时解决方法是将模型所有属性设为可空，但需修改大量关联代码，且模型均通过EF Core脚手架生成：

// 脚手架生成的Project模型示例
public partial class Project
{
    public int? Id { get; set; }
    public string? Code{ get; set; }
    public string? Name{ get; set; }
    public int? TotalDays { get; set; }
    public int? TotalEmployees { get; set; }
    public DateOnly? StartAt { get; set; }
    public DateOnly? EndAt { get; set; }
    public int? IdZone { get; set; }
    public string? NameZone { get; set; }
    public int? Periode { get; set; }
    public int? Year { get; set; }
    public int? Month { get; set; }
    public int? Week { get; set; }
    public string? Status { get; set; }
    public string? Notes { get; set; }
}

使用的脚手架命令：

dotnet ef dbcontext scaffold "Server=DB_IP;Port=5432;Database=ERPDB;User Id=XXXXX;Password=XXXXXXX;" Npgsql.EntityFrameworkCore.PostgreSQL --output-dir Erp/Models --context-dir Contexts --context DbContext

DbContext核心代码：

public partial class DbContext : DbContext
{
    public DbContext()
    {
    }

    public DbContext(DbContextOptions<DbContext> options)
        : base(options)
    {
    }

    public virtual DbSet<Project> Projects { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Project>(entity =>
        {
            entity.Property(e => e.EndAt).HasColumnName("end_at");
            entity.Property(e => e.Month).HasColumnName("month");
            entity.Property(e => e.Code).HasColumnName("code");
            entity.Property(e => e.Name).HasColumnName("name");
            entity.Property(e => e.Id).HasColumnName("id");
            entity.Property(e => e.TotalDays).HasColumnName("total_days");
            entity.Property(e => e.TotalEmployees).HasColumnName("total_employees");
            entity.Property(e => e.StartAt).HasColumnName("start_at");
            entity.Property(e => e.IdZone).HasColumnName("id_zone");
            entity.Property(e => e.NameZone).HasColumnName("name_zone");
            entity.Property(e => e.Periode).HasColumnName("periode");
            entity.Property(e => e.Year).HasColumnName("year");
            entity.Property(e => e.Month).HasColumnName("month");
            entity.Property(e => e.Week).HasColumnName("week");
            entity.Property(e => e.Status).HasColumnName("status");
            entity.Property(e => e.Notes).HasColumnName("notes");
        });
    }
}

1. 对齐本地与生产环境的.NET运行时版本 #

• 本地安装与Linux生产环境完全相同版本的.NET Core SDK/Runtime（包含补丁号），消除运行时差异导致的LINQ表达式解析或EF Core行为不一致。
• 在项目文件（.csproj）中明确锁定目标框架和运行时版本：

  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <RuntimeFrameworkVersion>7.0.15</RuntimeFrameworkVersion> <!-- 替换为生产环境使用的版本 -->
    <PublishReadyToRun>true</PublishReadyToRun>
  </PropertyGroup>
  

2. 优化EF Core脚手架生成逻辑 #

• 检查数据库字段约束：若业务中字段不应为NULL，在数据库层面设置NOT NULL约束，重新生成模型时EF Core会自动生成非可空属性，无需手动修改。
• 若无法修改数据库，使用脚手架参数增强模型生成的准确性：

  dotnet ef dbcontext scaffold "连接字符串" Npgsql.EntityFrameworkCore.PostgreSQL --output-dir Erp/Models --context-dir Contexts --context DbContext --data-annotations --no-onconfiguring
  

• 确保DbContext中的DbSet提前初始化，避免NULL：

  public virtual DbSet<Project> Projects { get; set; } = new DbSet<Project>();
  

3. 本地模拟生产环境测试 #

• 使用Docker搭建与生产环境一致的PostgreSQL/MySQL实例，匹配数据库版本、配置和测试数据。
• 启用可空引用类型，在编译阶段提前检测潜在NULL问题：
  在.csproj中添加：

  <Nullable>enable</Nullable>
  

• 本地发布为Linux目标运行时并测试：

  dotnet publish -c Release -r linux-x64 --self-contained false
  

  将发布后的程序在WSL或Linux虚拟机中运行，复现并排查问题。

4. 排查DbContext初始化问题 #

• 验证Linux环境中数据库连接字符串配置正确，确保appsettings.json等配置文件已正确复制，避免因连接失败导致DbSet未初始化。
• 在DbContext构造函数中添加初始化验证：

  public DbContext(DbContextOptions<DbContext> options) : base(options)
  {
      Projects ??= throw new InvalidOperationException("Projects DbSet未完成初始化");
      // 可选：提前验证数据库连接
      if (!Database.CanConnect())
          throw new InvalidOperationException("无法连接到目标数据库");
  }
  

5. 修正日志中的本地路径问题 #

• 发布时禁用调试符号生成，避免生产环境日志显示本地代码路径：

  dotnet publish -c Release -r linux-x64 --no-symbols
  

  或在.csproj中配置：

  <PropertyGroup>
    <DebugType>pdbonly</DebugType>
  </PropertyGroup>
  

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