Emdash CMS 部署验收与首次登录 FAQ
部署后的可执行验收步骤、首次管理端设置，以及「部分成功」状态的排查。
部署后最先该验证什么？
三层验收顺序：
- 前端可达：首页返回预期内容。
- 管理端可达：
/_emdash/admin能加载。 - 数据可写：创建并读取一条内容。
仅路由可达不等于部署完成。
为什么前端正常，管理端初始化却失败？
常见原因：
- 绑定不一致（
DB、MEDIA等） - 缺少环境变量或密钥
- 为 Free 套餐保留了不支持的配置
建议排查顺序：先绑定，再环境变量，再档位限制。
首次登录管理端会发生什么？
通常会：
- 创建管理员身份
- 注册凭据（如 Passkey）
- 写入初始系统状态
该步骤依赖浏览器与账号状态，请在稳定网络与支持良好的浏览器中完成。
Passkey 设置失败时先看什么？
按此顺序：
- 浏览器是否支持、Passkey 是否可用
- 系统时间是否准确
- 是否存在跨域或反向代理头问题
不要先怀疑数据库——多数认证问题在客户端或边缘代理。
什么是「最小生产验收脚本」？
可重复流程：
- 打开前端首页并记录响应。
- 登录管理端并完成初始设置。
- 创建并发布一条测试内容。
- 上传一个媒体文件并验证可访问。
- 确认前端能看到已发布内容。
由此验证路由、认证、写入、存储与读取。
部署看似成功但内容缺失，从哪查？
最短路径：
- 条目是否已发布（非草稿）。
- 前端是否查询了预期的集合。
- 查看运行时日志是否有查询或权限错误。
多数缺内容来自状态或查询路径，而非平台宕机。
团队如何把验收质量制度化？
纳入发布流程：
- 合并前：在本地或 staging 跑三层验收
- 发布后：值班同学在 10 分钟内执行最小脚本
- 事故后：新增一条确定性检查以防复发
可靠上线靠流程控制，不靠口耳相传。
验收命令片段
# 示例运行时检查
curl -I https://your-site.workers.dev
curl -I https://your-site.workers.dev/_emdash/admin
npx wrangler tail your-worker-name