TypeORM搭配Jest单元测试时如何正确加载.env.test连接测试数据库

• 项目配置开发、测试两套独立数据库实例，对应两份环境配置文件：开发环境使用.env，测试环境使用.env.test，目标为运行Jest单元测试时自动加载测试库配置完成连接，目前始终无法通过封装的connection.ts建立数据库连接
• 项目目录结构按规范搭建，包含独立环境加载模块、TypeORM CLI配置、标准业务代码分层结构

• 测试启动脚本已配置NODE_ENV=test参数
• 实现了自定义loadEnv环境加载逻辑
• 编写了分环境匹配的TypeORM连接选项定义
• NestJS业务模块内已配置双环境的TypeOrmModule适配逻辑

• 连接创建失败：调用getConnection()获取到的连接实例，isConnected状态始终为false
• 按名称查询连接抛出异常：调用getConnection('test')或getConnection('default')直接抛出“未找到连接”错误
• 测试运行时报配置缺失：执行npm test时提示“未在任何ORM配置文件中找到连接选项”
• 连接状态日志报错：打印连接状态时抛出ConnectionNotFoundError，提示“未找到名为'default'的连接”
• 仅当**硬编码传入完整数据库连接参数直接调用createConnection**时，才能正常建立连接

1. 修正环境加载的执行时序 #

这类问题的核心根因通常为：自定义loadEnv逻辑未在Jest启动的最优先阶段执行，导致后续TypeORM读取配置时，环境变量尚未注入进程。

• 调整Jest配置项，在jest.config.js/jest.config.ts中增加全局Setup文件配置：
  • 配置globalSetup字段，指向独立的test/env.setup.ts文件，在该文件内执行自定义loadEnv逻辑，根据当前进程的NODE_ENV=test标识，强制加载.env.test的所有变量到process.env
  • 不要将loadEnv逻辑仅放在NestJS模块的初始化阶段：Jest运行测试时如果未触发完整Nest应用启动流程，模块内的加载逻辑根本不会执行，TypeORM读取配置时自然无法获取参数
• 校验环境加载逻辑的路径匹配：如果自定义loadEnv读取.env.test使用相对路径，需校验Jest执行时的工作目录，避免出现“路径配置正确但实际查找文件位置偏差，导致读不到配置”的问题

2. 修正TypeORM连接配置的读取逻辑 #

• 检查封装的connection.ts中的环境判断逻辑：确保NODE_ENV匹配分支能准确命中test场景，避免出现“NODE_ENV为test时，仍然走开发环境配置分支”的判断错位
• 调整TypeORM CLI配置文件（ormconfig.ts/data-source.ts）的默认连接逻辑：确保CLI配置也会优先读取process.env中加载完成的测试环境变量，避免Jest运行时误读CLI硬编码的开发环境配置，导致“找不到连接选项”的报错
• 校验连接名称的一致性：避免出现Nest模块内将连接命名为test，但封装的getConnection逻辑默认查询default名称连接，引发的ConnectionNotFoundError

3. 适配Jest场景的连接初始化流程 #

• 在测试用例的生命周期Hook（如beforeAll）中，显式调用封装的createConnection逻辑，不要依赖全局的连接自动初始化：Jest的模块执行顺序为动态调度，无固定先后顺序，如果将连接初始化放在模块顶层，很容易出现“TypeORM连接配置代码执行时，环境变量尚未加载完成”的时序问题
• 排查报错时先打印当前进程的process.env值，确认.env.test的配置已被成功注入，再排查连接创建的逻辑分支，避免无方向排查

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