Orchard Record模型无效，遭遇预期不会触发的查询执行异常

首先，这个异常的核心问题是SQL查询定义的参数和实际传入的参数不匹配——SQL里用的是@p0，但系统试图绑定p1参数，这种情况在Orchard基于NHibernate的Record模型里，常见于以下几个场景：

1. Record类的映射属性与查询条件不匹配 #

检查你的CustomerRecord类和对应的映射（不管是Fluent NHibernate还是XML映射），确保：

• 查询中用到的属性（比如SystemId）都正确映射到数据库字段
• 属性的数据类型和数据库字段完全一致（比如SystemId是int还是long？类型不匹配可能导致参数绑定错位）

2. 查询构建时的参数顺序错误 #

如果你是手动构建NHibernate查询（比如用QueryOver或者HQL），要注意参数的添加顺序。比如：

// 错误示例：参数顺序和查询里的占位符不匹配
session.QueryOver<CustomerRecord>()
       .Where(cr => cr.DistId == someDistId)
       .And(cr => cr.SystemId == someSystemId)
       .SetParameter(0, someSystemId) // 这里参数索引错误，应该先绑定DistId对应的参数

Orchard的Repository默认会帮你处理参数绑定，但如果是自定义查询，一定要确保参数顺序和查询条件里的占位符顺序一致。

3. Record类的属性未正确标记 #

Orchard的Record类需要继承ContentPartRecord或者RecordBase，并且属性要用public virtual修饰（因为NHibernate需要动态代理）。比如：

// 正确的Record类示例
public class CustomerRecord : RecordBase {
    public virtual int SystemId { get; set; }
    public virtual Guid CustomerGuid { get; set; }
    // 其他属性...
}

如果属性没有加virtual，NHibernate可能无法正确生成代理，导致参数绑定逻辑混乱。

4. 缓存的映射文件过期 #

Orchard在启动时会生成NHibernate的映射文件，如果之前修改过Record类但没有重启应用，可能导致缓存的映射和实际模型不匹配。尝试：

• 重启你的Orchard应用
• 清除App_Data下的缓存目录（比如App_Data/Sites/[YourSite]/Cache）

快速排查步骤 #

1. 打印出你构建查询的代码，检查参数传入的顺序和数量
2. 对比CustomerRecord的属性和数据库表CustomerRecord的字段，确保一一对应
3. 尝试用Orchard的IRepository<CustomerRecord>的默认方法（比如Fetch）来查询，看是否还报错：

var customer = _customerRepository.Fetch(cr => cr.SystemId == 2).FirstOrDefault();

如果默认方法正常，那问题肯定出在你自定义的查询逻辑里。

补充：这个错误本质是NHibernate的参数绑定器无法找到对应的参数占位符，通常不是SQL语法问题，而是模型映射或查询构建的逻辑错误。

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