本地启动与部署排障

从哪里开始定位？

deploy/macos.py 提供 doctor、bootstrap、rebuild、start、stop、status 等入口；首次安装建立本项目独立环境，stop 保留卷和本机资料。

先用 status 读取本入口记录的状态，再检查该进程和端口是否仍匹配。不要结束所有Java或Node进程；它们可能属于其他项目。doctor发现工具不匹配时先修工具，构建失败不必重复数据库初始化。

常见现象对应哪个层次？

现象	优先检查	避免的操作
工具版本拒绝	Java/Maven/Node与锁文件	强行跳过版本门
应用不能连接数据库	目标库、运行角色、配置注入	改用超级账号长期运行
页面404或静态白屏	base路径、构建材料、代理入口	临时伪造成功响应
上传成功但图片不可读	桶ACL、基址、引用和配置版本	公开整个私有桶
修改请求被拒绝	会话、CSRF、权限与修订号	扩大URL白名单

健康成功为什么还可能有业务问题？

应用配置公开 health 与 info 端点并关闭健康详情展示；网关健康不能代替后端和业务链路检查。

网关健康只证明网关响应，应用健康也不能证明具体商品、订单或外部渠道可用。分层保留HTTP状态、traceId和脱敏错误类别，再核对实际接口。

如何准备支持材料？

提供提交、环境类型、出现时间、入口路径、影响范围和可复现步骤。日志中去掉密码、Cookie、完整联系方式和签名对象地址。涉及订单状态未知时先查询与对账，不直接重放付款、退款或发货。