成功部署需要关注以下技术细节:
- 环境配置:
- 必须设置正确的
NODE_VERSION
(推荐 18+) - API 密钥需以
VITE_
前缀暴露给前端(如VITE_DASHSCOPE_API_KEY
)
- 必须设置正确的
- 构建设置:
- 框架预设选择
React
- 构建命令应为
npm run build
- 输出目录需指定为
dist
- 框架预设选择
- 部署优化:
- 启用
Auto Minify
优化资源加载 - 配置合适的
Browser Cache TTL
(建议 4 小时) - 中国大陆用户可选 Hong Kong 节点加速
- 启用
故障排查指南:
- 构建失败优先检查
npm install
的依赖完整性 - 页面白屏需验证
index.html
的静态资源路径 - API 调用异常时检查 Cloudflare Workers 的跨域配置
本答案来源于文章《Botgroup.chat:多个AI角色实时互动的群聊天应用》