IDbConnection对象无法使用Dapper.Contrib方法的问题求助

嘿，我来帮你搞定这个困扰！你说的连接对象没法调用Dapper.Contrib的Insert()这类扩展方法，大概率是几个常见的小坑没踩对，我给你一步步排查：

• 首先，检查命名空间是否正确
  很多人会犯这个错：Dapper.Contrib的扩展方法其实在Dapper.Contrib.Extensions命名空间里，而不是Dapper.Contrib！所以你需要把引用改成：

  using Dapper;
  using Dapper.Contrib.Extensions; // 重点是这个！
  

  之前的using Dapper.Contrib;是没用的，扩展方法根本不在这个命名空间下。

• 确认NuGet包版本匹配
  确保你安装的Dapper和Dapper.Contrib版本是一致的——版本不兼容很容易导致扩展方法不生效。你可以在NuGet包管理器里检查两者的版本，尽量更新到同一个稳定版本。

• 检查实体类是否符合要求
  Dapper.Contrib的Insert()方法对实体类有一定要求：

  • 实体类必须有一个主键，要么命名为Id/ID（大小写不敏感），要么用[Key]特性标记主键属性，比如：

    public class Product
    {
        [Key]
        public int ProductId { get; set; }
        public string Name { get; set; }
        public decimal Price { get; set; }
    }
    

  如果没有主键，扩展方法可能无法正常识别，甚至不会出现在智能感知里。

• 尝试显式调用扩展方法
  有时候IDE的智能感知会抽风，明明方法存在却不显示。这时候你可以直接显式调用：

  var product = new Product { Name = "Test", Price = 9.99m };
  var newId = Dapper.Contrib.Extensions.SqlExtensions.Insert(connection, product);
  

  这样能绕过智能感知的问题，同时验证方法是否真的可用。

• 确认连接对象的可用性
  你用SqlConnection实现IDbConnection是没问题的，但要确保连接字符串正确，并且连接处于可用状态（Dapper会自动打开/关闭连接，但如果连接本身配置错误，也可能间接导致方法调用异常）。

我之前第一次用Dapper.Contrib的时候，就是栽在了命名空间上，改完using Dapper.Contrib.Extensions;之后，所有扩展方法立刻就出来了！你可以先试试这个最常见的问题。

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