如何解决Hibernate中Could not locate ordinal parameter [0]错误？

错误分析 #

第三种写法的明显错误 #

你第三种写法中，SQL拼接的参数是:${propertyName}（比如当传入的propertyName为config_for时，SQL里是:config_for），但调用setParameter("propertyName", value)时传入的参数名是固定字符串"propertyName"，和SQL中的实际参数名完全不匹配，必然会报Could not locate named parameter [propertyName]错误，这种写法直接丢弃即可。

前两种写法的错误根源 #

报错Could not locate ordinal parameter [0] expecting one of [1]，结合错误提示里的expecting one of [config_for]，说明实际传入的propertyName是config_for，问题出在HQL解析或参数绑定环节，以下是针对性解决方法：

解决方案 #

1. 验证传入的propertyName合法性 #

先确认调用getModel方法时，传入的propertyName是实体类中真实存在的字段名，而非数据库列名或拼写错误的名称。比如从错误提示看，实体类中应该有config_for字段，检查实体类的字段定义和映射注解（如@Column）是否正确。

2. 适配Hibernate版本的位置参数写法 #

部分旧版本Hibernate中，位置参数采用从0开始的索引，而非1。如果你用位置参数写法，修改为：

@Override
public T getModel(String propertyName, Object value) throws DAOException {
    StringBuilder strQuery = new StringBuilder();
    strQuery.append("from ");
    strQuery.append(getPersistentClass().getSimpleName());
    strQuery.append(" as c where c.");
    strQuery.append(propertyName);
    strQuery.append("=?"); // 去掉?1，只用?
    Query query = getHibernateSession().createQuery(strQuery.toString());
    query.setMaxResults(1);
    query.setParameter(0, value); // 索引从0开始
    return (T) query.uniqueResult();
}

3. 修复命名参数写法的潜在问题 #

第一种写法本身逻辑正确，但可能因会话缓存导致解析异常，尝试添加会话缓存清除操作，或改用更简洁的字符串格式化方式拼接HQL：

@Override
public T getModel(String propertyName, Object value) throws DAOException {
    String hql = String.format("from %s as c where c.%s = :%s",
            getPersistentClass().getSimpleName(),
            propertyName,
            propertyName);
    // 清除会话缓存，避免旧查询残留
    getHibernateSession().clear();
    Query query = getHibernateSession().createQuery(hql);
    query.setMaxResults(1);
    query.setParameter(propertyName, value);
    return (T) query.uniqueResult();
}

4. 打印生成的HQL语句排查问题 #

在代码中打印最终生成的HQL，确认语句格式正确：

String hql = strQuery.toString();
System.out.println("生成的HQL：" + hql); // 或用日志框架输出
Query query = getHibernateSession().createQuery(hql);

如果HQL中出现where c.=这类无效片段，说明传入的propertyName为空，需要检查调用方的传参逻辑。

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