添加事务后NestJS测试失败：外键约束冲突

核心问题拆解 #

• 表面报错指向project_group表的外键约束违反，但日志中却出现user表删除失败的错误，说明事务内的操作上下文传递存在异常，部分操作未纳入事务范围，导致事务逻辑混乱。
• typeorm-transactional-cls-hooked依赖CLS（Continuation Local Storage）传递事务上下文，而RequestContext.impersonate可能会中断CLS上下文，使得addProjectMember中的数据库操作脱离事务管控。

排查与修复步骤 #

1. 修复事务上下文传递问题 #

RequestContext.impersonate可能创建独立上下文，导致事务上下文丢失。调整代码结构，将事务逻辑嵌入impersonate内部，确保上下文继承：

await RequestContext.impersonate(invite.user, async () => {
  await runInTransaction(async () => {
    await this.projectService.addProjectMember(
      project,
      invite.invitedEmail,
      invite.role
    );
    await this.deleteInvite(invite);
  });
});

若自定义了RequestContext实现，需确认其兼容CLS，确保事务上下文能穿透impersonate回调。

2. 定位project_group外键约束触发源 #

先查询FK_a6e3f0560fc498dc3de01ee4250约束的关联关系（比如project_group的字段关联到project或user表）：

• 检查addProjectMember中是否存在隐式创建project_group记录的逻辑（比如实体关联的级联插入）
• 确认事务内创建的projectMember是否因上下文丢失，导致project_group引用了未提交的临时记录

3. 解决user表删除失败问题 #

日志中删除user失败是因为project_member存在关联记录，需针对性处理：

• 检查deleteInvite是否触发了用户级联删除，若需保留该逻辑，需先删除关联的project_member记录，或修改外键为ON DELETE CASCADE
• 排查测试用例，确认是否在事务执行前已创建了关联的project_member数据，导致删除冲突

4. 验证事务回滚机制 #

若删除操作不在事务内，失败后不会触发回滚，进而导致后续操作触发外键约束：

• 在事务内手动抛出错误，测试所有操作是否会回滚，验证事务有效性
• 确认typeorm-transactional-cls-hooked已正确初始化（比如在NestJS的main.ts中调用initializeTransactionalContext()）

额外建议 #

• 开启TypeORM事务日志，确认所有操作是否归属同一事务（日志会显示BEGIN TRANSACTION、COMMIT/ROLLBACK及事务ID）
• 检查ProjectMemberEntity与ProjectGroupEntity的关联配置，排查是否存在异常级联规则
• 单独测试addProjectMember和deleteInvite的逻辑，确认各自无问题后再组合到事务中

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