使用Wrangler部署Cloudflare Worker时出现Invalid Version TypeError求助

问题根源 #

错误栈指向utf7模块（被imap依赖，进而被imap-simple调用）的版本检测逻辑：该模块尝试通过process.version判断Node版本，但Cloudflare Workers的Node兼容环境中，process.version的格式不符合semver模块的预期，导致构造SemVer实例时抛出错误。

可行解决方案 #

方案一：替换为兼容Worker的IMAP库（推荐） #

imap-simple依赖的imap库较陈旧，依赖的utf7版本存在环境兼容问题，建议替换为现代且兼容Cloudflare Workers的imapflow：

1. 卸载旧依赖：

npm uninstall imap-simple imap

2. 安装imapflow：

npm install imapflow

3. 重构代码，使用imapflow的Promise式API替代imap-simple（你已存在@types/imapflow依赖，无需额外安装类型）。

方案二：修补utf7模块的版本检测逻辑（临时方案） #

通过修改utf7模块代码，跳过无效的版本检测：

1. 项目根目录创建patch/utf7-fix.js文件，内容如下：

const fs = require('fs');
const path = require('path');

const utf7Path = path.join(__dirname, '../node_modules/utf7/utf7.js');
let content = fs.readFileSync(utf7Path, 'utf8');

// 强制启用现代逻辑，跳过版本检测
content = content.replace(
  "if (semver.gte(process.version, 'v0.10.0')) {",
  "if (true) {"
);

fs.writeFileSync(utf7Path, content, 'utf8');

2. 在package.json的scripts中添加postinstall脚本，确保每次安装依赖后自动修补：

"scripts": {
  // 保留原有脚本...
  "postinstall": "node patch/utf7-fix.js"
}

3. 重新安装依赖并部署：

npm install
wrangler deploy

方案三：优化Wrangler Node兼容配置 #

更新Wrangler配置，获取更好的Node环境支持：

1. 修改wrangler.toml：

# 替换旧的compatibility_date为较新版本
compatibility_date = "2024-01-01"
# 替换node_compat为Wrangler 3.x的新兼容配置
nodejs_compat = true

2. 重新部署测试：

wrangler deploy

为什么之前的尝试无效 #

你设置的NODE_VERSION环境变量对utf7模块无效——该模块直接读取process.version，而非环境变量；Cloudflare Workers的Node兼容环境中，process.version的格式与本地Node环境不同，导致版本检测逻辑失败。

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