Java中Hibernate实体持久化问题：Session.save()抛出NullPointerException

以下是针对该问题的具体排查思路和解决建议：

1. 补全实体类的必要结构 #

你的MyEntity类缺少两个Hibernate要求的关键部分：

• 无参构造器：Hibernate通过反射实例化实体时必须依赖无参构造器，缺失会导致实例化失败进而引发空指针
• 属性的getter/setter方法：虽然注解标注在字段上时Hibernate可直接访问字段，但你代码中调用了entity.setName("Test Entity")，如果没有对应的setName方法，编译阶段就会报错；若实际代码中方法存在但内部逻辑有问题，也可能触发NPE

补全后的实体类示例：

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class MyEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    // 必须的无参构造器
    public MyEntity() {}

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

2. 验证SessionFactory初始化完整性 #

虽然代码中有异常捕获，但仍需确认SessionFactory是否真正初始化完成。可在获取Session前增加非空校验：

if (factory == null) {
    throw new IllegalStateException("SessionFactory初始化失败");
}
Session session = factory.openSession();

若触发该异常，说明hibernate.cfg.xml配置有误（如数据库连接参数错误、映射文件路径不对等），需重新检查配置文件内容。

3. 确认实体类在Hibernate配置中已映射 #

检查hibernate.cfg.xml是否包含MyEntity的映射配置，否则Hibernate无法识别该实体，在save操作时可能因找不到元数据引发内部空指针：

<!-- 替换为你的实体类全限定名 -->
<mapping class="com.yourpackage.MyEntity"/>

4. 升级SessionFactory初始化方式（针对Hibernate 5.x+版本） #

旧版的Configuration().configure().buildSessionFactory()在Hibernate 5及以上版本已过时，推荐使用新API确保初始化完整：

import org.hibernate.SessionFactory;
import org.hibernate.boot.MetadataSources;
import org.hibernate.boot.registry.StandardServiceRegistry;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;

// ...
try {
    StandardServiceRegistry registry = new StandardServiceRegistryBuilder()
            .configure()
            .build();
    factory = new MetadataSources(registry).buildMetadata().buildSessionFactory();
} catch (Throwable ex) {
    StandardServiceRegistryBuilder.destroy(registry);
    System.err.println("Failed to create session factory: " + ex);
    throw new ExceptionInInitializerError(ex);
}

5. 分析完整的NullPointerException堆栈信息 #

只看session.save(entity)行的报错不足以定位问题，需查看完整的堆栈跟踪：

• 若堆栈指向Hibernate内部类，通常是实体元数据缺失或SessionFactory初始化不完整导致
• 若堆栈指向你的实体类方法，说明实体类的getter/setter方法内部存在空指针逻辑

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