日志

按症状查日志前，先确认服务已启动且健康检查正常（/oars/actuator/health）。

日志在哪里

部署方式	常见位置
本机 / 源码启动	进程控制台；生产可配置文件日志（如 logs/oars-platform.log）
Docker / Compose	后端容器日志：podman logs --tail 200 oars-backend（或 docker logs）
前端网关容器	podman logs --tail 200 oars-frontend

生产环境的日志目录、采集与告警平台以现场配置为准；多环境日志级别约定见部署侧配置说明。

建议级别

环境	建议
开发	业务包可开 DEBUG，便于联调
测试	INFO 为主
生产	根级别偏保守（如 WARN），业务包 INFO；避免长期开 DEBUG

改级别后需重启或按现网热更新方式生效（以实际部署为准）。

按模块查什么

现象方向	日志关键词 / 关注点
启动失败	Flyway、Redis、datasource、端口占用、上传目录权限
登录 / Token	Unauthorized、JWT、blacklist、登录失败原因
权限 / 菜单	Permission、Forbidden、角色或菜单相关报错
流程	flow、实例启动失败、节点办理异常栈
表单	表单模板加载、选项源、校验失败
文档 / ONLYOFFICE	onlyoffice、callback、save_error、forcesave_error
文件上传	multipart、磁盘空间、目录不可写
限流	HTTP 429、限流相关提示

容器环境可先看最近 200 行，再按关键词过滤：

podman logs --tail 200 oars-backend 2>&1 | grep -iE 'error|exception|flyway|redis|jwt'

与其它排障页的关系

1. 先看 故障排查 对照症状。
2. 数据库与迁移见 数据库、Flyway。
3. ONLYOFFICE 联调见 ONLYOFFICE 实施。
4. 容器启停与卷见 Docker 部署。

检查项

• 健康检查是否已绿，再查业务日志，避免空跑。
• 是否查错实例（多副本时应对准实际处理请求的节点）。
• 生产是否误开 DEBUG 导致磁盘暴涨。
• 反向代理是否吞掉后端错误体，浏览器只看到 502/空白页。