opendance-web/web-server/scripts/check-bootstrap.mjs

#!/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();