#!/usr/bin/env node /** * 启动冒烟检查:**编译产物能不能真正 boot 起来**(不需要数据库)。 * * 为什么必须有这一层:`src/catalog/catalog.module.ts` 曾经漏了 `ScenesModule`, * 而 `CatalogService` 注入了 `ScenesService` —— Nest 的 DI 是**按模块**解析的, * 于是 `node dist/main.js` 在 bootstrap 阶段直接抛 `UnknownDependenciesException`, * **服务根本起不来**。但当时所有检查都是绿的: * - `nest build` 通过(类型没问题); * - 258 项单元测试通过(它们直接 new 服务 / 测纯函数,从不编译 AppModule); * - 打包脚本只校验文件清单与压缩包完整性。 * 结果就是 v0.7.0 / v0.7.1 的产物「装得上、起不来」。 * * 本脚本以**正式部署的方式**(systemd 的 `ExecStart=node dist/main.js`, * 不带任何 npm 环境变量)拉起真实产物,然后: * 1. 断言日志里**没有**依赖解析类错误(UnknownDependenciesException 等)→ 模块图可解析; * 2. 断言日志里的「应用版本 vX.Y.Z」等于 `package.json` 的 version * → 原生部署下版本号解析正确(原先会退化成硬编码的 0.1.0); * 3. 断言启动确实**推进到了数据库连接阶段** → 证明 Nest 已把整个 DI 图解析完, * 而不是中途失败。 * * 不需要数据库:TypeORM 连不上时日志里会出现明确的连接错误,那就够了 —— * 本脚本的职责是「启动能否走到连库这一步」,真连库的端到端验收由 * `test/smoke.mjs`(部署好服务端后运行)负责。 * * 用法:node scripts/check-bootstrap.mjs */ import { spawn } from 'node:child_process'; import { mkdtempSync, readFileSync } from 'node:fs'; import { tmpdir } from 'node:os'; import { dirname, join } from 'node:path'; import { fileURLToPath } from 'node:url'; const here = dirname(fileURLToPath(import.meta.url)); const serverDir = join(here, '..'); const entry = join(serverDir, 'dist', 'main.js'); const EXPECTED_VERSION = JSON.parse( readFileSync(join(serverDir, 'package.json'), 'utf8'), ).version; /** 依赖解析失败的标志(任一出现即失败) */ const DI_ERROR_PATTERNS = [ /UnknownDependenciesException/, /Nest can't resolve dependencies/i, /cannot resolve dependencies/i, /Nest can't resolve/i, ]; /** 走到数据库连接阶段的标志 */ const DB_STAGE_PATTERNS = [ /Unable to connect to the database/i, /ECONNREFUSED/, /getaddrinfo/i, /Access denied for user/i, /Unknown database/i, /服务已?启动/, /已启动,监听/, ]; const TIMEOUT_MS = Number(process.env.BOOTSTRAP_TIMEOUT_MS ?? 40_000); function freePort(base) { // 用一个不常见的端口即可;连库失败是预期的,端口只要不撞上真实服务 return base + Math.floor(Math.random() * 200); } async function main() { const scratch = mkdtempSync(join(tmpdir(), 'opendance-boot-')); // 模拟 systemd:删掉 npm_* 环境变量(ExecStart=node dist/main.js 时它们不存在) const env = { ...process.env }; for (const key of Object.keys(env)) { if (key.startsWith('npm_')) delete env[key]; } delete env.APP_VERSION; // 也不允许用显式覆盖,必须走 package.json Object.assign(env, { NODE_ENV: 'development', // 免得 validateEnv 在生产模式直接 exit(1) HOST: '127.0.0.1', PORT: String(freePort(34000)), ADMIN_PORT: String(freePort(35000)), DB_HOST: '127.0.0.1', DB_PORT: '3399', // 故意指向一个没有 MySQL 的端口 DB_USER: 'opendance_probe', DB_PASSWORD: 'opendance_probe', DB_NAME: 'opendance_probe', DB_LOGGING: 'false', STORAGE_DIR: join(scratch, 'storage'), ADMIN_DIR: join(scratch, 'admin'), }); const child = spawn(process.execPath, [entry], { cwd: serverDir, env, stdio: ['ignore', 'pipe', 'pipe'], }); let output = ''; let finished = false; const decide = () => { if (finished) return null; const diError = DI_ERROR_PATTERNS.find((re) => re.test(output)); if (diError) { finished = true; return { ok: false, reason: 'di', pattern: String(diError) }; } const versionLine = output.match(/应用版本 v(\S+)/); const dbStage = DB_STAGE_PATTERNS.some((re) => re.test(output)); if (versionLine && dbStage) { finished = true; return { ok: true, version: versionLine[1] }; } return null; }; const result = await new Promise((resolvePromise) => { const timer = setTimeout(() => { resolvePromise(decide() ?? { ok: false, reason: 'timeout' }); }, TIMEOUT_MS); const onData = (chunk) => { output += chunk.toString(); const decided = decide(); if (decided) { clearTimeout(timer); child.kill('SIGKILL'); resolvePromise(decided); } }; child.stdout.on('data', onData); child.stderr.on('data', onData); child.on('exit', () => { clearTimeout(timer); resolvePromise(decide() ?? { ok: false, reason: 'exit' }); }); child.on('error', (error) => { clearTimeout(timer); resolvePromise({ ok: false, reason: 'spawn', error: error.message }); }); }); if (result.ok) { if (result.version !== EXPECTED_VERSION) { console.error( `✗ 启动日志里的应用版本 v${result.version} 与 web-server/package.json 的 ${EXPECTED_VERSION} 不一致`, ); console.error(' (原生部署下版本号必须从 package.json 解析,不能依赖 npm 环境变量)'); process.exit(1); } console.log( `✓ 启动冒烟通过:模块依赖图可解析(无 UnknownDependenciesException)、` + `应用版本 v${result.version} 与 package.json 一致、已推进到数据库连接阶段`, ); return; } console.error('✗ 启动冒烟失败:'); if (result.reason === 'di') { console.error(` 依赖解析错误(匹配 ${result.pattern})—— 有模块忘记 import 提供者了。`); console.error(' 提示:检查各 @Module 的 imports 是否覆盖了构造函数里注入的服务。'); } else if (result.reason === 'timeout') { console.error(' 进程既没有报依赖错误,也没有推进到数据库连接阶段(超时)。'); } else if (result.reason === 'exit') { console.error(' 进程提前退出,且日志里既没有依赖错误也没有数据库阶段标志。'); } else if (result.reason === 'spawn') { console.error(` 无法启动 ${entry}:${result.error}`); } console.error('\n---- 进程输出(末尾 40 行)----'); console.error(output.split('\n').slice(-40).join('\n')); process.exit(1); } await main();