Cloudflare 构建与部署

构建链路复制标题链接

Next.js 经 OpenNext 构建为 .open-next/worker.js，静态资源位于 .open-next/assets。运行配置以 wrangler.jsonc 与 open-next.config.ts 为准。

pnpm build
pnpm preview
pnpm build:prod

preview 会构建并预览 Cloudflare 版本；build:prod 会构建并执行 Wrangler dry-run，不是正式部署。

发布前核对复制标题链接

1. 创建目标 Cloudflare 资源，更新自己的 D1、KV、Durable Object 等绑定。
2. 检查 Worker 名称、自引用服务和自定义域名，不能直接沿用另一项目的资源 ID。
3. 保持站点 URL、认证 URL 与正式域名一致。
4. 配置真实环境 Secret，包括存储、认证及按需启用的 AI、支付和邮件凭据。
5. 审阅并应用生产数据库迁移。
6. 通过类型检查、相关测试和 Worker dry-run，再进入正式发布。

Secret 与迁移命令复制标题链接

以下命令属于正式发布操作，文档只说明流程，不会自动执行：

pnpm exec wrangler secret put STORAGE_ACCESS_KEY_ID
pnpm exec wrangler secret put STORAGE_SECRET_ACCESS_KEY
pnpm db:migrate:prod
pnpm deploy

使用命名环境时补充对应环境参数。公开变量须在构建时提供，运行时 Secret 不能代替已打包的客户端配置。

上线确认复制标题链接

检查登录、简历保存、公开分享、对象上传以及已开放的 AI 功能。确认 Token 额度与计费迁移已应用；未配置平台密钥或开关时应展示不可用状态。

构建或 dry-run 通过不代表真实模型、支付回调或生产数据已完成验证。