Nest.js Sequelize全局事务提交异常：外键约束错误排查

问题场景 #

在Nest.js项目中基于Sequelize实现全局事务管理：

• 编写了全局TransactionInterceptor拦截器处理事务生命周期
• 通过自定义TransactionParam装饰器在控制器中获取事务实例，再传递给服务层执行数据库操作

调用createCompany接口时出现异常：

创建User、Company记录成功，但插入company_users关联表时触发错误：
insert or update on table "company_users" violates foreign key constraint "company_users_user_id_fkey"

错误原因分析 #

查看数据库日志后定位问题：

• User、Company的创建操作使用了全局事务实例（trx）
• company_users的创建操作使用了Sequelize默认事务，未加入全局事务上下文

由于全局事务未提交，User的主键数据仅存在于当前事务的会话中，并未持久化到数据库。此时company_users用默认事务插入时，数据库无法找到对应的User主键，触发外键约束校验失败。

解决方案 #

排查代码后发现，调用this.companyUsersService.createCompanyUser时未传入全局事务实例（trx参数），导致该操作脱离了全局事务范围。

修复方式：
在控制器中调用companyUsersService.createCompanyUser时，将通过TransactionParam装饰器获取到的trx参数传递进去，确保company_users的创建操作与User、Company的创建处于同一个全局事务中。

示例代码片段：

// 控制器中的createCompany方法
@Post()
@UseInterceptors(TransactionInterceptor)
async createCompany(
  @Body() createCompanyDto: CreateCompanyDto,
  @TransactionParam() trx: Transaction, // 通过装饰器获取全局事务实例
) {
  const user = await this.userService.create(createCompanyDto.user, trx);
  const company = await this.companyService.create(createCompanyDto.company, trx);
  // 关键：传递trx参数到关联表创建方法
  await this.companyUsersService.createCompanyUser({
    userId: user.id,
    companyId: company.id,
  }, trx);
  return { user, company };
}

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