使用Wrangler v3.78在Cloudflare Workers中操作KV时运行报错求助

错误原因 #

这个错误源于Cloudflare Workers Runtime不支持Node.js核心模块（如node:stream），你的环境中某个依赖或Wrangler版本本身的问题，导致代码尝试动态引入了该模块，最终引发Runtime启动失败。你的Worker业务代码本身没有直接调用node:stream，问题出在项目配置、依赖或Wrangler版本兼容性上。

修复步骤 #

1. 清理项目依赖 #

• 打开package.json检查依赖项，确认是否安装了依赖Node.js环境的包（比如stream、fs这类Node.js核心模块的封装包）。如果有，执行以下命令移除：

  npm uninstall [多余的依赖包名]
  

• 重新执行npm install，确保依赖安装干净。

2. 调整Wrangler版本 #

Wrangler v3.78可能存在兼容性bug，切换到稳定版本尝试：

# 降级到已知稳定版（如v3.77.0）
npm install wrangler@3.77.0 -D
# 或直接升级到最新稳定版
npm install wrangler@latest -D

3. 检查wrangler.toml配置 #

• 如果配置中有node_compat = true，改为node_compat = false（Workers默认不需要Node.js兼容模式，除非你明确需要使用Node.js模块）。
• 确认KV绑定配置正确（你的代码用到了env.BINDING_NAME，必须在配置中声明）：

  [[kv_namespaces]]
  binding = "BINDING_NAME"
  id = "你的KV命名空间ID" # 可通过`wrangler kv:namespace create "自定义命名空间名"`获取
  preview_id = "预览环境KV命名空间ID" # 同样通过上述create命令获取
  

4. 清理Wrangler缓存 #

缓存异常也可能引发问题，执行以下命令重置：

wrangler cache clean

验证修复 #

完成上述操作后重新运行wrangler dev，若错误消失，可测试Worker功能：

• 发送POST请求到/store并携带文本数据，验证KV存储功能。
• 发送GET请求到/retrieve，验证数据能否正常读取。

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