DAO Testing异常：测试未生效、无法获取ID问题排查

问题对应测试代码 #

public void createTimesheet_returns_timesheet_with_id_and_expected_values() {
        Timesheet createdTimesheet = sut.createTimesheet(testTimesheet);

        Assert.assertNotNull("createTimesheet returned null", createdTimesheet);
        Integer newId = createdTimesheet.getId();
        Assert.assertTrue("createProject failed to return a project with an id", newId > 0);

        testTimesheet.setId(newId);
        assertTimesheetsMatch("createProject returned project with wrong or partial data", testTimesheet, createdTimesheet);
    }

核心排查方向 #

• 实体ID生成策略配置缺失
  检查Timesheet实体主键注解：如果使用数据库自增主键，JPA/Hibernate场景下未给ID字段添加@GeneratedValue(strategy = GenerationType.IDENTITY)注解，持久化后框架不会自动将生成的主键回填到实体对象，getId()会直接返回null或者初始值0，触发ID断言失败。如果使用序列生成主键，需确认关联的序列在数据库中真实存在，序列名配置与注解一致。
• DAO层create方法未配置ID回填
  MyBatis场景下最常见的问题是insert标签未配置ID回填参数：没有加useGeneratedKeys="true" keyProperty="id"属性时，插入操作完成后不会把数据库生成的ID赋值到传入的实体对象中，如果create方法直接返回入参对象，拿到的实例ID始终为空。JPA场景下需确认create方法返回的是持久化上下文中的托管实体，而非手动new的游离对象，调用persist()后不要额外拷贝属性丢失托管态。
• 事务配置异常导致操作未实际提交
  检查测试类的事务配置：如果测试方法默认开启事务回滚、或者事务边界配置错误，插入操作没有实际提交到数据库，不仅无法获取生成的ID，还可能出现create方法返回null的情况。同时排查create方法内部是否有异常捕获逻辑吞掉了持久化报错，直接返回null导致后续逻辑根本不执行。
• 前置断言失败中断测试流程
  测试执行时优先在assertNotNull位置打断点确认：如果createdTimesheet本身为null，后续取ID、校验属性的逻辑会直接中断，表现为测试逻辑未正常执行，此时需要往前排查create方法的参数校验逻辑，是不是入参不符合要求直接返回了null。
  注意：当前测试代码的断言提示文字是复制Project相关测试时遗留的错误，报错时会显示createProject相关提示，不会影响逻辑执行，但建议修正避免排查误导。

参考配置示例 #

MyBatis插入语句ID回填配置：

<insert id="createTimesheet" parameterType="com.xxx.Timesheet" useGeneratedKeys="true" keyProperty="id">
    INSERT INTO timesheet (employee_id, start_date, end_date, status)
    VALUES (#{employeeId}, #{startDate}, #{endDate}, #{status})
</insert>

JPA实体主键配置：

@Entity
@Table(name = "timesheet")
public class Timesheet {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    // 其余字段、getter/setter省略
}

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