日志与监控
服务端日志
sh
bun wrangler tail --config apps/api/wrangler.jsonc --env staging生产选择空环境名。先确认目标服务和环境,再用请求标识关联接口错误、用户操作和数据库状态。三个 Worker 的日志分别查看,入口成功不等于下游接口成功。
本地排查
bun run preview:status 显示受管理服务状态,.local 保存对应日志和邮件捕获记录。更改构建产物后重新启动预览;不要误停其他对比模板服务。
观察什么
关注接口错误率、响应耗时、数据库连接、邮件发送失败、支付回调失败、工具失败与重复请求。公开站访问统计由 websiteConfig.analytics 控制,可按需接入 Cloudflare 的公开页面统计;它不是业务错误监控。
日志只保存必要的错误类型和标识,不记录密码、认证 token、支付密钥或用户文件正文。建立告警时先确认通知通道真实可用。
回滚与成本
发布失败先确认各服务版本及数据库迁移是否已执行,再选择补齐发布或回滚兼容代码。Worker 回滚不会恢复数据库和第三方订阅状态。
分别观察 Worker、数据库、存储与外部服务用量。当前主站未接入对象存储、队列或生成模型,不应把这些模块的费用纳入“已验证免费运行”结论。