[Bug] Wrangler deployment fails due to unresolved "safer-buffer" dependency in iconv-lite

首先检查部署报告中提到的依赖声明和 Wrangler 配置，然后追踪在执行 pnpm run deploy 时如何包含 iconv-lite。先运行 pnpm install，再运行 pnpm run deploy 以复现问题，并检查是否缺少 safer-buffer 或需要 Wrangler 别名。部署包能够解析该依赖，且 Wrangler 能继续越过报告中的构建错误时，即表示完成。

Please confirm the following

• I confirm my description is clear and polite, that I have provided the necessary diagnostic information, and that this is reproducible on the latest version.
• I confirm I have checked the relevant documentation and existing issues / discussions, and this report is not a duplicate.
• I confirm this is an issue with the Worker project, not caused by network or user error, and not an issue specific to the Go version.
• I confirm I have read the open-source license / disclaimers / usage policy, and understand that I bear all risks of use.

Version (required)

82bd05d

Platform (required)

Cloudflare Workers

DB_FORMAT (required)

map (single JSON blob)

DB_DRIVER (required)

auto

Storage Driver (required)

NONE

Bug Description (required)

Steps to reproduce:

1. Clone the OpenList-Worker repository.
2. Install dependencies using pnpm install.
3. Run the deployment command: pnpm run deploy.

Expected result:
The project should bundle successfully and deploy to Cloudflare Workers without errors.

Actual behavior:
The build process fails during the npx wrangler deploy step. Wrangler reports multiple errors stating it cannot resolve the safer-buffer module, which is a dependency of iconv-lite. The error message suggests adding an alias to the Wrangler configuration, but the current project config does not include this fix.

Error Information (required)

The full deploy log:

❯ pnpm run deploy
$ node scripts/deploy.js
[KV] wrangler.jsonc 已声明 KV 绑定（省略 id 字段），由 wrangler 自动创建/复用。

[构建] 正在获取官方前端构建产物 ...

$ node scripts/fetch-frontend.mjs
[fetch-frontend] Fetching official frontend build artifacts...
  Querying registry: https://registry.npmjs.org (@openlist-frontend/openlist-frontend)
  Downloading published dist: @openlist-frontend/[email protected]
  > curl -fL --retry 3 -o "/tmp/openlist-frontend-npm-WXMmDl/pkg.tgz" "https://registry.npmjs.org/@openlist-frontend/openlist-frontend/-/openlist-frontend-4.2.8.tgz"
  % Total    % Received % Xferd  Average Speed  Time    Time    Time   Current
                                 Dload  Upload  Total   Spent   Left   Speed
 74 31.41M  74 23.47M   0      0 384.7k      0   01:23   01:02   00:21 214.8k 75 31.41M  75 23.64M   0      0 381.1k      0   01:24   01:03 76 31.41M  76 23.95M   0      0 380.1k      0   01:24   01:04 77 31.41M  77 24.18M   0      0 376.6k      0   01:25   01:05 77 31.41M  77 24.34M   0      0 368.4k      0   01:27   01:07 78 31.41M  78 24.53M   0      0 365.5k      0   01:27   01:08 78 31.41M  78 24.70M   0      0 361.4k      0   01:28   01:09 79 31.41M  79 24.92M   0      0 358.9k      0   01:29   01:11 79 31.41M  79 25.05M   0      0 355.6k      0   01:30   01:12 79 31.41M  79 25.05M   0      0 350.7k      0   01:31   01:13 80 31.41M  80 25.36M   0      0 350.2k      0   01:31   01:14 81 31.41M  81 25.52M   0      0 346.4k      0   01:32   01:15 81 31.41M  81 25.68M   0      0 343.7k      0   01:33   01:16 82 31.41M  82 25.96M   0      0 338.8k      0   01:34   01:18 83 31.41M  83 26.16M   0      0 334.4k      0   01:36   01:20 83 31.41M  83 26.35M   0      0 332.0k      0   01:36   01:21 84 31.41M  84 26.39M   0      0 327.6k      0   01:38   01:22 84 31.41M  84 26.63M   0      0 326.0k      0   01:38   01:23 85 31.41M  85 26.74M   0      0 323.3k      0   01:39   01:24 85 31.41M  85 26.88M   0      0 320.9k      0   01:40   01:25 85 31.41M  85 26.99M   0      0 318.5k      0   01:40   01:26 86 31.41M  86 27.08M   0      0 314.0k      0   01:42   01:28 86 31.41M  86 27.25M   0      0 312.0k      0   01:43   01:29 87 31.41M  87 27.36M   0      0 309.3k      0   01:43   01:30 87 31.41M  87 27.52M   0      0 305.9k      0   01:45   01:32 88 31.41M  88 27.70M   0      0 303.6k      0   01:45   01:33 88 31.41M  88 27.81M   0      0 301.0k      0   01:46   01:34 89 31.41M  89 28.00M   0      0 298.6k      0   01:47   01:36 89 31.41M  89 28.14M   0      0 296.8k      0   01:48   01:37 89 31.41M  89 28.24M   0      0 294.2k      0   01:49   01:38 90 31.41M  90 28.36M   0      0 292.3k      0   01:50   01:39 90 31.41M  90 28.45M   0      0 290.0k      0   01:50   01:40 91 31.41M  91 28.62M   0      0 287.1k      0   01:52   01:42 91 31.41M  91 28.75M   0      0 285.1k      0   01:52   01:43 91 31.41M  91 28.84M   0      0 283.2k      0   01:53   01:44 92 31.41M  92 28.92M   0      0 280.9k      0   01:54   01:45 92 31.41M  92 29.04M   0      0 279.0k      0   01:55   01:46 92 31.41M  92 29.11M   0      0 276.8k      0   01:56   01:47 92 31.41M  92 29.14M   0      0 274.4k      0   01:57   01:48 93 31.41M  93 29.29M   0      0 273.2k      0   01:57   01:49 93 31.41M  93 29.39M   0      0 271.4k      0   01:58   01:50 93 31.41M  93 29.50M   0      0 269.2k      0   01:59   01:52 94 31.41M  94 29.59M   0      0 266.7k      0   02:00   01:53 94 31.41M  94 29.72M   0      0 265.1k      0   02:01   01:54 94 31.41M  94 29.81M   0      0 263.6k      0   02:01   01:55 95 31.41M  95 29.88M   0      0 261.8k      0   02:02   01:56 95 31.41M  95 30.03M   0      0 260.4k      0   02:03   01:58 95 31.41M  95 30.10M   0      0 257.5k      0   02:04   01:59 96 31.41M  96 30.23M   0      0 255.3k      0   02:05   02:01 96 31.41M  96 30.33M   0      0 253.7k      0   02:06   02:02 96 31.41M  96 30.40M   0      0 252.3k      0   02:07   02:03 97 31.41M  97 30.48M   0      0 250.6k      0   02:08   02:04 97 31.41M  97 30.55M   0      0 248.8k      0   02:09   02:05 97 31.41M  97 30.55M   0      0 246.8k      0   02:10   02:06 97 31.41M  97 30.72M   0      0 246.3k      0   02:10   02:07 97 31.41M  97 30.72M   0      0 244.3k      0   02:11   02:08 98 31.41M  98 30.89M   0      0 243.1k      0   02:12   02:10 98 31.41M  98 30.93M   0      0 241.5k      0   02:13   02:11 98 31.41M  98 31.03M   0      0 240.1k      0   02:13   02:12 99 31.41M  99 31.10M   0      0 238.4k      0   02:14   02:13 99 31.41M  99 31.21M   0      0 237.2k      0   02:15   02:14 99 31.41M  99 31.31M   0      0 235.7k      0   02:16   02:15 99 31.41M  99 31.38M   0      0 234.3k      0   02:17   02:17100 31.41M 100 31.41M   0      0 234.1k      0   02:17   02:17100 31.41M 100 31.41M   0      0 234.1k      0   02:17   02:17100 31.41M 100 31.41M   0      0 234.1k      0   02:17   02:17          78495
  > tar -xzf pkg.tgz package/dist package/package.json
  Copying frontend dist: /tmp/openlist-frontend-npm-WXMmDl/package/dist -> /home/alex/tech/OpenList-Worker/dist
  Copied static/manifest.json -> manifest.json (frontend #162)
  Stamped frontend-version 4.2.8 into dist/index.html
  Patched manifest link with crossorigin=use-credentials in dist/index.html
✓ Frontend dist ready (/home/alex/tech/OpenList-Worker/dist)

[部署] 正在部署到 Cloudflare Workers ...

$ npx wrangler deploy
npm warn Unknown project config "node-linker". This will stop working in the next major version of npm. See `npm help npmrc` for supported config options.
npm warn Unknown project config "shamefully-hoist". This will stop working in the next major version of npm. See `npm help npmrc` for supported config options.
npm notice run [email protected] npx
npm notice run 'wrangler' deploy
▲ [WARNING] Proxy environment variables detected. We'll use your proxy for fetch requests.



 ⛅ wrangler 4.118.0
────────────────────

✘ [ERROR] Build failed with 8 errors:

  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/encodings/dbcs-codec.js:2:21:
        2 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  
  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/encodings/internal.js:2:21:
        2 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  
  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/encodings/sbcs-codec.js:2:21:
        2 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  
  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/encodings/utf16.js:2:21:
        2 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  
  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/encodings/utf32.js:3:21:
        3 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  
  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/encodings/utf7.js:2:21:
        2 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  
  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/lib/index.js:3:21:
        3 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  
  ✘ [ERROR] Could not
  resolve "safer-buffer"
  
      node_modules/iconv-lite/lib/streams.js:3:21:
        3 │ var Buffer =
  require("safer-buffer").Buffer
          ╵                      ~~~~~~~~~~~~~~
  
    To fix this, you can add an entry to "alias" in your
  Wrangler configuration.
    For more guidance see:
  https://developers.cloudflare.com/workers/wrangler/configuration/#bundling-issues
  
  
  


🪵  Logs were written to "/home/alex/.config/.wrangler/logs/wrangler-2026-10-24_13-38-43_541.log"
node:internal/errors:999
  const err = new Error(message);
              ^

Error: Command failed: npx wrangler deploy
    at genericNodeError (node:internal/errors:999:15)
    at wrappedFn (node:internal/errors:544:14)
    at checkExecSyncError (node:child_process:990:11)
    at execSync (node:child_process:1062:15)
    at run (file:///home/alex/tech/OpenList-Worker/scripts/deploy.js:58:12)
    at main (file:///home/alex/tech/OpenList-Worker/scripts/deploy.js:85:3)
    at file:///home/alex/tech/OpenList-Worker/scripts/deploy.js:98:1
    at ModuleJob.run (node:internal/modules/esm/module_job:569:25)
    at async node:internal/modules/esm/loader:650:26
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:105:5) {
  status: 1,
  signal: null,
  output: [ null, null, null ],
  pid: 316201,
  stdout: null,
  stderr: null
}

Node.js v26.12.1
[ELIFECYCLE] Command failed with exit code 1.

Relevant Configuration (required)

Note: I have not yet configured the account/project IDs, but the build fails before reaching that stage. The following wrangler.jsonc is generated by grep -v '^\s*//' wrangler.jsonc | grep -v '^\s*$'.

{
  "name": "openlist-tsworkers",
  "main": "src/backend/worker.ts",
  "compatibility_date": "2026-08-04",
  "compatibility_flags": ["nodejs_compat"],
  "workers_dev": false,
  "preview_urls": false,
  "assets": {
    "directory": "./dist",
    "binding": "ASSETS",
    "run_worker_first": ["/", "/index.html"]
  },
  "vars": {
    "ENVIRONMENT": "production",
    "DB_FORMAT": "map",
    "DB_DRIVER": "auto",
    "DB_CIPHER": "none",
    "CACHE_ENABLED": "true",
    "CACHE_DRIVER": "db",
    "CACHE_FILE_TREE": "true",
    "CACHE_DOWNLOAD_LINK": "false",
    "CACHE_TTL": "0",
    "CACHE_LINK_TTL": "5",
    "CACHE_EXCLUDE_DRIVERS": "virtual,alias,url_tree,strm,chunk",
    "SINGLEFLIGHT": "auto",
  },
}

Reproduction Link (optional)

No response