数据库存在指定ID条目，为何getContactById方法返回null？

以下是几种可能的原因及排查方向：

• 实体与数据库映射不匹配

  • 核对Contact实体类的主键配置：@Id、@GeneratedValue的策略要和数据库主键生成方式一致，比如数据库用自增，实体类就不能用SEQUENCE策略。
  • 检查表名、字段名映射：确认@Table注解指定的表名和数据库实际表名一致，实体类的id字段对应的数据库列名是否正确（尤其是大小写敏感的数据库，比如PostgreSQL）。

• HQL语句有误

  • HQL里的id是实体类的字段名，不是数据库列名。如果实体类主键字段叫contactId而非id，这条查询就会找不到数据。
  • 可以临时换成session.get(Contact.class, id)这种API测试，对比HQL的结果，排查是不是HQL写法的问题。

• 事务与Session异常未处理

  • 原代码没做异常捕获，可能事务提交失败或者Session初始化出问题了却没发现。建议加上try-catch-finally块，打印异常信息，同时确保Session正确关闭：

    public Contact getContactById(int id) {
        Contact contact=null;
        Session session = null;
        Transaction transaction = null;
        try {
            session = sessionFactory.openSession();
            transaction = session.beginTransaction();
            // 也可以用更简洁的get方法测试：contact = session.get(Contact.class, id);
            Query query = session.createQuery("from Contact where id=:id");
            query.setParameter("id",id);
            List<Contact> list = query.list();
            transaction.commit();
            if(!list.isEmpty()) {
                contact=list.get(0);
            }
        } catch (Exception e) {
            if (transaction != null) {
                transaction.rollback();
            }
            e.printStackTrace(); // 打印异常才能发现问题
        } finally {
            if (session != null && session.isOpen()) {
                session.close();
            }
        }
        return contact;
    }
    

• 数据或参数问题

  • 确认传入的id参数值确实存在于数据库中，有没有传错（比如把100写成10）；如果数据库主键是bigint类型，代码用int可能会导致数值截断，建议改成long类型参数试试。
  • 检查数据库隔离级别，是否有其他未提交的事务占用了这条数据，导致当前查询读不到。

• 缓存干扰

  • 虽然每次都是新开Session，但可以试试禁用查询缓存：query.setCacheable(false)，或者在查询前调用session.clear()清空Session缓存，排查是不是缓存导致的旧数据问题。

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