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
相关产品推荐
相关产品推荐

