Dapper多映射报错：splitOn列'Id'未找到问题求助

核心原因 #

这个报错的本质是：你用Dapper多映射（QueryAsync多实体映射）时指定的splitOn列（这里是Id），在动态修改后的SQL返回结果里找不到了。

具体排查方向 #

• 检查修改后的SQL返回列：直接执行动态生成后的SQL，看结果集里有没有Id列。大概率是你移除Audit字段的字符串操作，不小心把主实体的Id列或者多映射依赖的拆分列给删掉了。比如用了不严谨的字符串替换（比如直接替换包含"Audit"的内容），误删了类似AuditId或者主表的Id列。
• 核对splitOn参数的合理性：如果多映射是关联主实体和Audit实体，splitOn通常指定的是关联实体的主键（比如AuditId），但移除Audit字段后，结果集里已经没有这个列了，还继续用原来的splitOn参数就会报错。另外，如果原来的SQL返回多个Id列（主表和Audit表各一个），移除Audit后只剩一个，但splitOn还是写了多个列，也会触发错误。
• 检查字符串操作逻辑：比如用正则或者Replace处理SQL的SELECT字段时，有没有精准匹配Audit相关字段？不要直接用sql = sql.Replace("Audit", "")这种粗暴操作，应该精准定位到SELECT列表里的Audit字段（比如a.CreatedBy, a.CreatedTime这类），只删除这些明确的字段，保留主实体的必要列（比如p.Id）。

修复建议 #

1. 动态调整splitOn参数：如果移除Audit字段后，不需要再映射Audit实体，那就改成单实体映射（比如QueryAsync<Product>），而不是继续用多映射。如果还是需要多映射其他实体，要确保splitOn指定的列在修改后的SQL结果里存在。
2. 优化SQL修改逻辑：不要用字符串硬替换，而是把SELECT字段拆成列表，过滤掉Audit相关的字段后再重新拼接SQL。比如：

   var selectFields = new List<string> { "p.Id", "p.Name", "a.CreatedBy", "a.CreatedTime" };
   if (!isAdministrator)
   {
       selectFields.RemoveAll(f => f.StartsWith("a.")); // 移除Audit相关字段
   }
   var sql = $"SELECT {string.Join(", ", selectFields)} FROM Products p LEFT JOIN Audits a ON p.Id = a.ProductId";
   

3. 调试时输出完整SQL：在执行前打印修改后的SQL，直接去数据库里执行，确认返回的列是否符合预期，再和splitOn参数对比。

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