You need to enable JavaScript to run this app. Jest测试时数据库清理失效引发PostgreSQL主键唯一约束冲突如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Jest测试时数据库清理失效引发PostgreSQL主键唯一约束冲突如何解决

Jest测试触发sites表主键重复报错的排查与修复

问题根因

按优先级从高到低排查,你编写的测试数据库逻辑存在4处明确的硬错误,直接导致旧数据残留触发主键冲突:

  • Promise.all传参规则用错:Promise.all仅接受1个可迭代参数(即需要并行等待的Promise数组),你当前所有Promise.all调用都把两组Promise拆成两个独立参数用逗号分隔传入,第二个参数的所有SQL语句会被直接忽略,从未被执行等待。
  • 删除条件字段完全错配:报错提示的唯一约束是sites_pkey,也就是sites表的id数字主键。但你写删除语句时,错误把过滤条件写成了DELETE FROM sites WHERE site_id='${site.id}'——用主键的数字值(比如id=3)去匹配site_id字段(存的是'site 3'这类字符串站点标识),完全无法匹配到旧数据,删库操作等于空跑。
  • 插入逻辑未正确等待:你插入sites数据时,直接把sitesData.map()返回的Promise数组当数组元素传入Promise.all,没有做数组拍平,导致插入逻辑没有正确覆盖所有SQL执行,Jest运行测试时可能重复触发插入语句,撞上前一次残留的主键。
  • 删除顺序违反外键约束:你当前的删除流程先删主表studies数据,再删关联表sites数据,但sites.study_id是引用studies.id的外键,先删主表会被外键约束拦截,导致整个删除流程中断,旧数据完全没清掉。

可落地的修复方案

  • 清理逻辑简化:直接用TRUNCATE sites, studies RESTART IDENTITY CASCADE做全表清理,替代逐行删除的逻辑——这条语句会连带清空关联表数据、重置主键自增序列,完全避免手写删除条件的错配问题,也符合外键约束要求。
  • 修正Promise.all的参数结构:把所有需要并行执行的删除、插入Promise用展开语法合并成同一个数组传入,不要拆成多个参数。
  • 调整执行顺序:先执行表清理操作,再依次插入主表studies数据、关联表sites数据,避免外键引用报错。

修复后核心参考代码

async function clearDatabase() {
  // 级联清空关联表,重置自增主键序列
  await dbClient.query("TRUNCATE sites, studies RESTART IDENTITY CASCADE");
}

async function initializeDatabase() {
  await dbClient.connect();
  // 前置执行清理,杜绝历史测试残留
  await clearDatabase();

  // 插入主表studies数据
  await Promise.all([
    dbClient.query("INSERT INTO studies (id, internal_study_name, start_date) values ('DEFAULT1', 'Test DEFAULT SITE', '2030-10-10T08:00:00.000Z')"),
    dbClient.query("INSERT INTO studies (id, internal_study_name, start_date) values ('DEFAULT2', 'Test DEFAULT SITE 2', '2030-10-10T08:00:00.000Z')"),
  ]);

  // 拍平所有sites插入语句,确保所有SQL被正确等待
  await Promise.all([
    ...sitesData.map(site => dbClient.query(
      `INSERT INTO sites (id, name, address, city, country_code, study_id, site_id, status, timezone, "default") 
       VALUES(${site.id}, '${site.name}','${site.address}', '${site.city}', '${site.country_code}', '${site.study_id}', '${site.site_id}', '${site.status}', '${site.timezone}', ${site.default})`
    )),
    ...sitesData2.map(site => dbClient.query(
      `INSERT INTO sites (id, name, address, city, country_code, study_id, site_id, status, timezone, "default") 
       VALUES(${site.id}, '${site.name}','${site.address}', '${site.city}', '${site.country_code}', '${site.study_id}', '${site.site_id}', '${site.status}', '${site.timezone}', ${site.default})`
    )),
  ]);

  const { rows: input } = await dbClient.query(`SELECT name, address, study_id, "default", country_code, site_id, status FROM sites`);
  Data.value = input;
}

额外注意:你原逻辑在clearDatabase里调用了dbClient.disconnect(),但initializeDatabase在beforeAll钩子每次执行时都会重新连接,在Jest多worker并行运行测试的场景下,连接状态不同步会偶发报错。改成上面的清理逻辑后,不需要每次断连,保持测试期间的数据库连接稳定即可。

内容的提问来源于stack exchange,提问作者Jakub

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 19:15:04