如何判断PrismaClient实例是否处于事务执行状态？

在Prisma的交互式事务中，我们会拿到一个事务专属的txnClient，你希望判断传入的PrismaClient实例是否是这种事务内的客户端，从而让函数支持「独立开事务」或「共享已有事务」两种模式，这是合理的场景需求，但需要注意以下几点：

核心结论 #

Prisma官方没有提供公开的官方API来直接检测实例是否处于事务中。你测试的'$transaction' in prisma判断方式，本质是利用了Prisma的内部实现细节：事务内的客户端（txnClient）会移除$transaction方法，而原始PrismaClient实例保留该方法。但这不属于官方承诺的稳定特性，未来版本可能会变更，不建议作为长期依赖的实现方式。

推荐的稳妥实现方案 #

依赖内部细节存在风险，更可靠的方式是显式控制事务上下文，比如：

方案1：通过参数标识控制 #

给函数增加一个参数，明确告知是否使用已有事务：

async function someWork(prisma: PrismaClient, useExistingTx = false): Promise<unknown> {
  if (useExistingTx) {
    // 直接使用传入的事务客户端执行操作
    return prisma.user.create({ data: { name: 'test' } });
  } else {
    // 开启新事务执行逻辑
    return prisma.$transaction(async (txn) => {
      return txn.user.create({ data: { name: 'test' } });
    });
  }
}

// 使用示例：
// 1. 独立执行，自动开启事务
await someWork(prisma);
// 2. 在已有事务中共享执行
await prisma.$transaction(async (txn) => {
  await someWork(txn, true);
  // 其他事务内操作
});

方案2：通过类型辅助+运行时判断（兼容内部实现） #

如果不想增加额外参数，可以通过类型别名辅助区分，同时保留运行时判断，但需标注风险：

// 类型别名辅助区分事务内客户端（仅作提示，不具备强类型校验）
type PrismaTxClient = Omit<PrismaClient, '$transaction'>;

async function someWork(prisma: PrismaClient | PrismaTxClient): Promise<unknown> {
  if ('$transaction' in prisma) {
    // 普通客户端，开启新事务
    return prisma.$transaction(async (txn) => {
      return txn.user.create({ data: { name: 'test' } });
    });
  } else {
    // 事务内客户端，直接执行
    return (prisma as PrismaTxClient).user.create({ data: { name: 'test' } });
  }
}

注意：这种方式依然依赖Prisma的内部实现，若未来版本调整事务客户端的方法集合，该判断会失效。

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