基于抽象基类使用DapperContrib执行Update操作遇问题求助

我来帮你搞定这个问题，这个报错的核心就是Dapper.Contrib找不到你的实体类里的主键标识——哪怕用了抽象基类，只要配置到位就能解决。下面我一步步给你排查方向和解决方案：

1. 先检查抽象基类的主键配置 #

Dapper.Contrib需要实体的主键属性必须是public可访问的，并且正确标记了[Key]（自增主键）或[ExplicitKey]（手动指定的主键，比如Guid）。如果基类的主键是private/protected，或者没加标记，肯定会报错。

举个正确的基类示例：

using Dapper.Contrib.Extensions;

public abstract class Document
{
    // 自增主键用[Key]，非自增用[ExplicitKey]
    [Key]
    public int Id { get; set; }
    
    // 其他公共属性
    public DateTime CreatedTime { get; set; }
    public string Creator { get; set; }
}

2. 确保具体类没有破坏主键的继承 #

如果你的UpdateProposal类重新定义了主键属性（比如又写了一遍public int Id { get; set; }），那基类的[Key]标记就会失效。正确的做法是直接继承基类的主键，不要重复定义：

public class UpdateProposal : Document
{
    // 只加具体类独有的属性即可
    public string ProposalTitle { get; set; }
    public string ProposalContent { get; set; }
}

如果确实需要重写主键属性（比如改变访问级别），一定要在重写的属性上重新标记[Key]/[ExplicitKey]：

public class UpdateProposal : Document
{
    [Key]
    public new int Id { get; set; } // 重写时必须重新加标记
    
    // 其他属性...
}

3. 检查通用更新方法的泛型约束 #

你的通用方法如果是泛型实现，要确保类型约束不会限制Dapper.Contrib识别实体属性。比如不要加不必要的约束，或者确保泛型参数是你的实体基类/具体类：

using Dapper.Contrib.Extensions;
using System.Data.SqlClient;

public class DocumentRepository
{
    private readonly string _connectionString;

    public DocumentRepository(string connectionString)
    {
        _connectionString = connectionString;
    }

    // 泛型方法约束为Document基类即可
    public bool UpdateDocument<T>(T entity) where T : Document
    {
        using (var conn = new SqlConnection(_connectionString))
        {
            return conn.Update(entity);
        }
    }
}

4. 额外排查点 #

• 如果你的主键是非自增的（比如Guid），一定要用[ExplicitKey]代替[Key]，[Key]默认对应数据库的自增列，用错会导致识别失败。
• 清理项目并重新编译：有时候Visual Studio的缓存元数据会导致属性标记不被识别，clean后rebuild试试。
• 检查是否有多个主键标记：比如不小心给多个属性加了[Key]，Dapper.Contrib也会报错。

你说把UpdateProposal改成Document还是报错，大概率是基类的主键属性要么没加标记，要么访问级别不是public，先重点检查这两点！

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