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

项目开发复盘报告:题库适配器与平台迁移

好的,这是一份经过整理和条理化的复盘报告,涵盖了您提供的所有内容。 项目开发复盘报告:题库适配器与平台迁移 本文档旨在系统地复盘“为 tikuAdapter 新增适配端点”任务从初期开发、环境配置、数据兼容性处理,直至最终平台迁移与自动化部署的完整过程。报告详细记录了关键任务、遇到的问题、解决方案及宝贵的经验教训。 I. 核心API端点开发与初期问题解决 1.1 任务目标 创建一个新的 API 端点 /tikuAdapter,该端点能够接收特定格式请求,调用外部题库 API (api.tikuhai.com),并将返回数据转换为 tikuAdapter 所需的 JSON 格式。 1.2 已完成工作 新增 /tikuAdapter 端点:在 src/app.js 中成功添加了路由和 handleTikuAdapterSearch 处理函数。 实现数据格式转换:在 handleTikuAdapterSearch 中编写核心逻辑,将 api.tikuhai.com 的响应重组,包括保留 question 和 options,并动态生成 answerKey、answerIndex、answerKeyText 和 answerText 等字段。 1.3 遇到的问题及解决方案 问题一:服务器连接重置 现象: curl 测试时收到 (56) Recv failure: Connection was reset 错误。 分析: 服务器处理请求时意外终止或崩溃。 解决方案: 检查 request.log 日志文件,定位导致崩溃的具体异常。 问题二:处理 options 字段时的类型错误 现象: 日志显示 TypeError: Cannot read properties of undefined (reading 'indexOf')。 分析: 当客户端请求 JSON 不含 options 字段时,options 变量为 undefined,导致后续调用 indexOf 失败。 解决方案: 增加防御性编程:const options = data....

2025-08-05 · 3 min

项目开发复盘报告:题库适配器与平台迁移

好的,这是一份经过整理和条理化的复盘报告,涵盖了您提供的所有内容。 项目开发复盘报告:题库适配器与平台迁移 本文档旨在系统地复盘“为 tikuAdapter 新增适配端点”任务从初期开发、环境配置、数据兼容性处理,直至最终平台迁移与自动化部署的完整过程。报告详细记录了关键任务、遇到的问题、解决方案及宝贵的经验教训。 I. 核心API端点开发与初期问题解决 1.1 任务目标 创建-一个新的 API 端点 /tikuAdapter,该端点能够接收特定格式请求,调用外部题库 API (api.tikuhai.com),并将返回数据转换为 tikuAdapter 所需的 JSON 格式。 1.2 已完成工作 新增 /tikuAdapter 端点:在 src/app.js 中成功添加了路由和 handleTikuAdapterSearch 处理函数。 实现数据格式转换:在 handleTikuAdapterSearch 中编写核心逻辑,将 api.tikuhai.com 的响应重组,包括保留 question 和 options,并动态生成 answerKey、answerIndex、answerKeyText 和 answerText 等字段。 1.3 遇到的问题及解决方案 问题一:服务器连接重置 现象: curl 测试时收到 (56) Recv failure: Connection was reset 错误。 分析: 服务器处理请求时意外终止或崩溃。 解决方案: 检查 request.log 日志文件,定位导致崩溃的具体异常。 问题二:处理 options 字段时的类型错误 现象: 日志显示 TypeError: Cannot read properties of undefined (reading 'indexOf')。 分析: 当客户端请求 JSON 不含 options 字段时,options 变量为 undefined,导致后续调用 indexOf 失败。 解决方案: 增加防御性编程:const options = data....

2025-08-05 · 3 min