.NET 8下ASP.NET Core+EF Core更新Match记录的问题与优化

1. 为何Match变量无法保留引用？ #

Razor Pages是无状态的Web框架，OnGetAsync和OnPostAsync属于两个完全独立的HTTP请求。PageModel类的实例会在每个请求时重新创建，所以OnGetAsync中赋值的Match字段，到OnPostAsync请求时会被重置为null，不会自动保留状态。

另外，如果PageModel中没有给Match字段添加[BindProperty]特性，表单提交的数据也无法自动绑定到该字段，进一步导致Post时Match为null。

2. 构建此类页面的最佳实践 #

• 规范依赖注入：通过构造函数注入DbContext，避免在方法内手动实例化，符合ASP.NET Core的依赖注入原则。
• 使用[BindProperty]绑定模型：标记需要从表单接收数据或跨请求暂存的属性，配合[Required]等验证特性做模型校验。
• 异步优先：所有EF Core操作使用异步方法（如FirstOrDefaultAsync、SaveChangesAsync），避免阻塞主线程。
• 正确加载关联数据：编辑时使用Include或ThenInclude加载关联实体（比如Match对应的Team），避免懒加载导致的异常。
• 用EF Core迁移替代EnsureCreated()：EnsureCreated()不会生成迁移文件，无法跟踪数据库结构变更，生产环境建议用Add-Migration和Update-Database管理数据库架构。
• 错误处理与状态反馈：操作失败时添加模型错误，返回页面显示提示；成功后重定向到列表页（PRG模式：Post-Redirect-Get），避免重复提交。

相关代码示例 #

1. 实体模型 #

public class Team
{
    public int Id { get; set; }
    public string Name { get; set; }
    public ICollection<Match> Matches { get; set; } = new List<Match>();
}

public class Match
{
    public int Id { get; set; }
    public DateTime MatchDate { get; set; }
    public int HomeTeamId { get; set; }
    public int AwayTeamId { get; set; }
    public int HomeScore { get; set; }
    public int AwayScore { get; set; }

    public Team HomeTeam { get; set; }
    public Team AwayTeam { get; set; }
}

2. DbContext配置（Fluent API） #

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

    public DbSet<Team> Teams { get; set; }
    public DbSet<Match> Matches { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置Match与Team的一对多关系
        modelBuilder.Entity<Match>()
            .HasOne(m => m.HomeTeam)
            .WithMany(t => t.Matches)
            .HasForeignKey(m => m.HomeTeamId)
            .OnDelete(DeleteBehavior.Restrict);

        modelBuilder.Entity<Match>()
            .HasOne(m => m.AwayTeam)
            .WithMany() // AwayTeam不反向关联Matches
            .HasForeignKey(m => m.AwayTeamId)
            .OnDelete(DeleteBehavior.Restrict);
    }
}

3. 问题代码（原PageModel） #

// 不规范的构造函数+无BindProperty导致Post时Match为null
public class EditModel : PageModel
{
    private FootballDbContext _context;

    // 错误：手动实例化DbContext，未使用依赖注入
    public EditModel()
    {
        _context = new FootballDbContext(new DbContextOptions<FootballDbContext>());
    }

    // 错误：未添加[BindProperty]，表单数据无法绑定，且跨请求不保留
    public Match Match { get; set; }

    public async Task<IActionResult> OnGetAsync(int id)
    {
        Match = await _context.Matches
            .Include(m => m.HomeTeam)
            .Include(m => m.AwayTeam)
            .FirstOrDefaultAsync(m => m.Id == id);

        if (Match == null)
        {
            return NotFound();
        }
        return Page();
    }

    public async Task<IActionResult> OnPostAsync()
    {
        // 此处Match为null，引发空引用异常
        if (!ModelState.IsValid)
        {
            return Page();
        }

        _context.Attach(Match).State = EntityState.Modified;
        await _context.SaveChangesAsync();

        return RedirectToPage("./Index");
    }
}

4. 修改后的可行代码 #

public class EditModel : PageModel
{
    private readonly FootballDbContext _context;

    // 规范：构造函数注入DbContext
    public EditModel(FootballDbContext context)
    {
        _context = context;
    }

    // 添加[BindProperty]，允许表单绑定并暂存状态
    [BindProperty]
    public Match Match { get; set; }

    public async Task<IActionResult> OnGetAsync(int? id)
    {
        if (id == null)
        {
            return NotFound();
        }

        Match = await _context.Matches
            .Include(m => m.HomeTeam)
            .Include(m => m.AwayTeam)
            .FirstOrDefaultAsync(m => m.Id == id);

        if (Match == null)
        {
            return NotFound();
        }
        return Page();
    }

    public async Task<IActionResult> OnPostAsync()
    {
        if (!ModelState.IsValid)
        {
            return Page();
        }

        try
        {
            _context.Attach(Match).State = EntityState.Modified;
            await _context.SaveChangesAsync();
        }
        catch (DbUpdateConcurrencyException)
        {
            if (!MatchExists(Match.Id))
            {
                return NotFound();
            }
            else
            {
                throw;
            }
        }

        return RedirectToPage("./Index");
    }

    private bool MatchExists(int id)
    {
        return _context.Matches.Any(e => e.Id == id);
    }
}

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