Cloudflare Workers + KV Mock API 部署踩坑总结

Cloudflare Workers + KV Mock API 部署踩坑总结 1. 环境变量 DB_JSON 超过 5.1KB 限制 问题:直接用 wrangler secret put DB_JSON < db.json 注入大文件时报错:Text binding ‘DB_JSON’ is too large。 解决:改用 Cloudflare KV 存储大数据,Worker 运行时从 KV 读取。 2. wrangler.toml 配置格式错误 问题:[[kv_namespaces]] 下写了 name、type、account_id 等字段,导致 warning。 解决:[[kv_namespaces]] 下只保留 binding 和 id,其他字段放到文件顶层。 3. 写入 KV 时命令格式错误 问题:用 wrangler kv:key put 或 wrangler kv:namespace create 等老版本命令,或参数顺序、语法不对。 解决:新版 wrangler 用空格分隔,如: 创建命名空间:wrangler kv namespace create DB 写入数据:wrangler kv key put --binding=DB DB_JSON "$(Get-Content -Raw db....

2025-08-05 · 1 min

Cloudflare Workers + Vue 项目部署全流程踩坑复盘

Cloudflare Workers + Vue 项目部署全流程踩坑复盘 1. 目标与环境 Vue3 + Vite + TypeScript + TailwindCSS mock API(json-server 数据)支持 多平台自动化部署(GitHub Pages、Deno Deploy、Cloudflare Workers) 统一 API base 配置,环境变量区分开发/生产 2. CI/CD 文件与平台 .github/workflows/ci-cd.yml:GitHub Pages 自动部署,含 base 路径 patch .github/workflows/deno-deploy.yml:Deno Deploy 自动部署,支持静态+mock API .github/workflows/cloudflare-pages.yml:Cloudflare Pages 部署(后期未用) .github/workflows/cloudflare-workers.yml:Cloudflare Workers 自动部署,mock API 支持 3. 主要问题与解决办法 3.1 wrangler.toml 配置与 secrets 注入 问题:wrangler.toml 里 account_id = "${{ secrets.CF_ACCOUNT_ID }}" 只有 wrangler-action@v4+ 支持,v3 需写死账号ID。 解决:升级 wrangler-action 到 v3,配合 wrangler 4.x,支持 secrets 注入。 3....

2025-08-05 · 2 min

Cloudflare Workers + Vue 项目部署踩坑与解决方案总结

Cloudflare Workers + Vue 项目部署踩坑与解决方案总结 1. CI/CD 及多环境部署目标 需求:Vue3 + Vite 项目,支持 GitHub Actions 自动部署到 Cloudflare Workers,mock API(json-server 数据)可用,静态资源与 API 一体化。 2. 主要问题与解决办法 2.1 wrangler.toml 配置与 secrets 注入 问题:wrangler.toml 里 account_id = "${{ secrets.CF_ACCOUNT_ID }}" 只有 wrangler-action@v4+ 支持,v3 需写死账号ID。 解决:升级 wrangler-action 到 v3,配合 wrangler 4.x,支持 secrets 注入。 2.2 wrangler 4.x 静态资源绑定 问题:assets = "./dist" 报类型错误,需对象格式,且字段应为 directory。 解决:用 [assets]\ndirectory = "./dist"。 2.3 mock 数据 DB_JSON 注入 问题1:直接用 $GITHUB_ENV 注入 base64,内容过长会被截断,导致 atob 报错。 问题2:wrangler....

2025-08-05 · 1 min