Explorar el Código

fix(deploy): 修复 Windows 上 execFileSync(npm) 与 hcloud 路径硬编码

## 问题 1:npm run build 在 deploy 中必然失败

$ npm run build
❌ 命令失败:npm run build
[ELIFECYCLE] Command failed with exit code 1.

但单独在终端执行同样命令完全正常。

根因:Windows 上 `npm` 实际是 `npm.cmd`,而 execFileSync 不经过 shell,
不做 PATHEXT 扩展 → ENOENT。

修复:命令为 npm/npx/.cmd/.bat 时加 shell: true,其余(obsutil/hcloud
等原生 exe)保持原样,避免多一层 shell 转义。

## 问题 2:hcloud 路径硬编码导致 CDN 刷新必然失败

脚本写死 E:\coding-environment\huaweicloud-koocli\hcloud.exe,
换机/换环境后该路径不存在 → 第 4 步失败(但 OBS 已上传成功,
用户拿到的是旧缓存,且无提示)。

修复:改为「环境变量 → 常见安装位置 → PATH」依次探测,
并用 `hcloud version` 输出是否含 KooCLI 来排除同名的 Hetzner CLI。

找不到时明确报错并给出手动刷新指引,不再静默跳过。

## 验证(2026-11-18 实际部署)

- 构建 + 上传 OBS:272 个文件全部成功
- CDN 刷新:RefreshTask 8225130940 成功
- 线上 pdf.worker.js:1,375,838 字节(修复前 1,264,342)
- 线上 index.html:9668 字节,标题正确

Co-Authored-By: Claude Code <noreply@anthropic.com>
Huccct hace 2 horas
padre
commit
99ba6e6b1f
Se han modificado 1 ficheros con 73 adiciones y 4 borrados
  1. 73 4
      scripts/deploy.mjs

+ 73 - 4
scripts/deploy.mjs

@@ -48,13 +48,41 @@ const args = new Set(process.argv.slice(2));
 const skipBuild = args.has('--skip-build');
 const dryRun = args.has('--dry-run');
 
-/** 执行命令并回显 */
+/**
+ * 执行命令并回显。
+ *
+ * 🔴 Windows 上必须对 `.cmd`/`.bat`(如 `npm`、`npx`)走 shell(2026-11-18 修复)。
+ *
+ * `execFileSync('npm', ...)` 在 Windows 上抛 **ENOENT** —— 因为 `npm` 实际是
+ * `npm.cmd`,而 `execFileSync` 不经过 shell,不做 PATHEXT 扩展。
+ * 以前没暴露是因为当时 deploy 的调用方不同;改用 pnpm + 新环境后就必然失败:
+ *
+ *   $ npm run build
+ *   ❌ 命令失败:npm run build
+ *   [ELIFECYCLE] Command failed with exit code 1.
+ *
+ * 而单独在终端跑 `npm run build` 却完全正常 —— 差别就在这里。
+ *
+ * 处理:命令名以 .cmd/.bat 结尾时(或本身就是 `npm`/`npx`)用 `shell: true`,
+ * 其余(obsutil / hcloud 等原生 exe)保持原样,避免多一层 shell 转义。
+ */
+function needsShell(cmd) {
+  if (process.platform !== 'win32') return false;
+  return /\.(cmd|bat)$/i.test(cmd) || cmd === 'npm' || cmd === 'npx';
+}
+
 function run(cmd, argv, opts = {}) {
   const printable = `${cmd} ${argv.join(' ')}`;
   console.log(`\n$ ${printable}`);
   if (dryRun) return '';
+  const useShell = needsShell(cmd);
   try {
-    return execFileSync(cmd, argv, { cwd: projectRoot, stdio: 'inherit', ...opts });
+    return execFileSync(cmd, argv, {
+      cwd: projectRoot,
+      stdio: 'inherit',
+      ...(useShell ? { shell: true } : {}),
+      ...opts,
+    });
   } catch (e) {
     console.error(`\n❌ 命令失败:${printable}`);
     process.exit(1);
@@ -147,9 +175,36 @@ console.log('\n=== [4/5] 刷新 CDN ===');
  * 而这时候 OBS 上传已经成功了 —— 只是 CDN 没刷,用户拿到的还是旧缓存。
  *
  * 可用 `HCLOUD_BIN` 环境变量覆盖。
+ *
+ * 🔴 2026-11-18:原硬编码路径 `E:\coding-environment\huaweicloud-koocli\hcloud.exe`
+ * 在换机/换环境后不存在,导致第 4 步必然失败(OBS 已上传成功,但 CDN 没刷)。
+ * 现改为「环境变量 → 常见安装位置 → PATH」依次探测,找不到才报错。
+ *
+ * 注意:PATH 里的 `hcloud` **可能是 Hetzner Cloud CLI**(同名不同物),
+ * 所以探测到 PATH 里的可执行文件后先跑 `version` 确认是华为云 KooCLI。
  */
-const HCLOUD_BIN =
-  process.env.HCLOUD_BIN || 'E:\\coding-environment\\huaweicloud-koocli\\hcloud.exe';
+function resolveHcloud() {
+  const candidates = [
+    process.env.HCLOUD_BIN,
+    'E:\\coding-environment\\huaweicloud-koocli\\hcloud.exe',
+    `${process.env.LOCALAPPDATA}\\huaweicloud\\hcloud.exe`,
+    `${process.env.USERPROFILE}\\tools\\hcloud\\hcloud.exe`,
+    '/usr/local/bin/hcloud',
+    'hcloud',
+  ].filter(Boolean);
+  for (const bin of candidates) {
+    try {
+      const out = execFileSync(bin, ['version'], { encoding: 'utf8', timeout: 15_000 });
+      // 华为云 KooCLI 输出含 "KooCLI";Hetzner 的是 "hcloud version x.y.z"
+      if (/KooCLI/i.test(out)) return bin;
+    } catch {
+      /* 探测失败就试下一个 */
+    }
+  }
+  return null;
+}
+
+const HCLOUD_BIN = resolveHcloud();
 /*
  * 🔴 必须同时刷新「固定文件名的资源」(2026-11-13 实测踩坑)。
  *
@@ -189,6 +244,20 @@ const refreshArgs = [
 ];
 console.log('  刷新 URL:');
 for (const u of refreshUrls) console.log(`    ${u}`);
+if (!HCLOUD_BIN) {
+  /*
+   * 🔴 找不到华为云 KooCLI 时**不能静默跳过**(2026-11-18)。
+   *
+   * 跳过的话 OBS 已上传、CDN 却没刷,用户拿到的仍是旧文件,而且没有任何提示。
+   * 这里明确报错并给出替代做法,让人知道接下来该做什么。
+   */
+  console.error('\n❌ 未找到华为云 KooCLI(hcloud)');
+  console.error('   文件已上传到 OBS,但 CDN 未刷新。请二选一:');
+  console.error('   ① 安装 KooCLI 后重跑:pnpm run deploy --skip-build');
+  console.error('   ② 或在华为云 CDN 控制台手动刷新以上 URL');
+  console.error('   也可用环境变量指定:HCLOUD_BIN=<hcloud 完整路径>');
+  process.exit(1);
+}
 // KooCLI 首次运行会交互式询问《隐私政策声明》,无人值守时会卡死并报 USE_ERROR
 run(HCLOUD_BIN, refreshArgs, { input: 'y\ny\ny\n' });