# 发布与日志

区分发布、部署和业务运行结果，找到环境日志查询入口，并保留可追踪的错误证据。

发布后先核对版本和正式入口，再完成一次真实业务操作，并用对应日志验证结果。部署成功或健康检查通过，只说明对应阶段成功。

## 按问题选择入口

| 要确认的事情                | 查看位置                                                                                                                        |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| 后端源码是否成功发布成不可变版本      | 后端项目的 Release Operation 和构建结果。                                                                                              |
| 目标环境是否部署成功、迁移是否完成     | Deployment、Migration Operation 及 Attempt；见 [发布验证与故障排查](/development/backend-development/verification-and-troubleshooting/)。 |
| 某次业务请求为何失败、迁移执行输出是什么  | Hosted Service 的 [环境日志查询与错误排查](/development/backend-development/logs-and-errors/)。                                          |
| Runtime 方法、下游调用在哪一步失败 | [Runtime 日志与调用链路](/features/runtime-logs/)。                                                                                 |
| 工作流执行到了哪个节点           | [工作流执行记录](/features/workflows/#查看执行记录)。                                                                                     |
| 平台应用授权回跳或接口权限异常       | [平台应用安全与故障排查](/development/bundle-development/platform-application-development/security-and-troubleshooting/)。              |
| HTTP 200 为什么仍然报错      | [CModel 错误模型](/integration/cmodel-error-model/)，依据非零 `errorCode` 判断业务失败。                                                    |

## 查看 Runtime 调用链路

工作区顶部的 **Runtime 日志** 按 Runtime 查询 ARMS 调用记录和详情。它与下方按后端环境查询的 Hosted Service 日志是两个入口；参数、权限范围和 CLI 示例见 [Runtime 日志与调用链路](/features/runtime-logs/)。

## 查看 Hosted Service 日志

CLI 入口是 `baijimu hosted-service debug`。`logs-search` 按条件搜索，`logs-trace` 按请求或 Trace 标识追踪；详细命令和结果示例见 [环境日志查询与错误排查](/development/backend-development/logs-and-errors/)。

每次必须选择工作区、项目、一个后端环境和时间窗口。这个入口返回所选环境的运行与迁移日志，不是整个项目或所有平台服务的日志集合。

## 定位一次失败请求

1. 记录故障发生时间和时区、入口、版本、公开错误码及可用的请求标识。
2. 确认前端请求是否发出，并区分传输失败与 CModel 业务失败。
3. 按目标环境和时间查询日志，确认业务处理是否执行。
4. 用请求标识关联业务处理、外部调用和数据更新；工作流同时核对节点执行记录。
5. 如果业务日志为空，检查环境、时区、过滤条件、采集与保留范围，以及请求是否到达业务进程。
6. 如果日志查询本身报错，保留查询错误交由对应权限管理员或平台维护者处理，不能把它解释成“没有业务日志”。

提交排查信息时保留脱敏证据，不包含 Token、Cookie、密码或完整敏感请求体。

## 发布完成标准

项目、环境、正式入口和版本信息应一致；发布与部署已进入成功终态，健康检查和真实业务操作通过，并能找到相应日志或执行记录。需要回滚或继续修改时，以这些证据作为依据。