使用Wrangler开发Cloudflare无服务器API遇Node内置模块解析错误

问题根源 #

1. Node.js专属模块不兼容：fs/promises、http2是Node.js环境特有的模块，Cloudflare Workers运行在V8 Isolate无服务器环境中，不提供文件系统访问能力，也不支持http2模块——即使启用node_compat，也只能polyfill少量核心Node API，这类模块无法在Workers中运行。问题触发点是依赖antibotbrowser，它底层依赖了Puppeteer相关包，而Puppeteer完全依赖Node.js的文件系统、进程管理能力，与Workers环境完全冲突。

2. typescript依赖缺失：依赖链中的cosmiconfig模块在打包时尝试加载typescript解析配置，但typescript仅在你的devDependencies中，未被纳入Worker打包范围，导致构建报错。

3. 无效构建命令：wrangler.toml中的[build] command="npm run"是无效命令，会触发错误的构建流程，干扰Wrangler默认的TypeScript处理逻辑。

解决步骤 #

1. 移除不兼容依赖 #

删除antibotbrowser包，它无法在Workers环境中运行：
修改package.json：

{
    "name": "cloudflare-workers-openapi",
    "version": "0.0.1",
    "private": true,
    "scripts": {
        "deploy": "wrangler deploy",
        "dev": "wrangler dev",
        "start": "wrangler dev",
        "cf-typegen": "wrangler types"
    },
    "dependencies": {
        "@cloudflare/itty-router-openapi": "^1.0.1"
    },
    "devDependencies": {
        "@cloudflare/workers-types": "^4.20240620.0",
        "@types/node": "20.8.3",
        "@types/service-worker-mock": "^2.0.1",
        "typescript": "^5.5.3",
        "wrangler": "^3.60.3"
    }
}

执行npm install更新依赖。

2. 修复Wrangler配置 #

删除wrangler.toml中的无效[build]块，让Wrangler使用默认构建流程：

#:schema node_modules/wrangler/config-schema.json
name = "imdb-api"
main = "src/index.ts"
compatibility_date = "2024-06-20"

node_compat = true

[triggers]
crons = [ "* * * * *" ]

3. 验证修复 #

执行wrangler dev，此时构建应正常完成，不再出现模块解析错误。

替代方案（若需浏览器自动化功能） #

如果你的业务需要浏览器渲染能力，不要使用Puppeteer，改用Cloudflare官方的Browser Rendering绑定：

1. 在wrangler.toml中启用Browser绑定：

[browser]
binding = "MY_BROWSER"

2. 通过绑定的MY_BROWSER对象调用浏览器API，完全适配Workers环境，无需依赖Node.js专属模块。

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