title: OA 运维故障排查决策树 (Troubleshooting) created: 2026-04-21 updated: 2026-04-21 type: guide tags: [ops, troubleshooting, e9, maintenance, flowchart] related: [oa/index.md]
OA 运维故障排查决策树
本指南用于快速定位 OA 系统运行中的常见问题。请按流程图一步步排查。
1. 全局流程：OA 打不开/无法访问
graph TD
A[OA 无法访问] --> B{Ping 服务器通吗？}
B -- 不通 --> C[检查服务器网络/防火墙]
C --> C1[云控制台安全组是否放行 80/443?]
C --> C2[本地防火墙 iptables/firewalld]
B -- 通 --> D{Caddy/Nginx 活着吗？}
D -- 没活 --> E[重启 Web 服务]
D -- 活着 --> F{Tomcat 活着吗？}
F -- 没活 --> G[检查 ecology 进程/jvm.log]
F -- 活着 --> H[浏览器 F12 看 Console 报错]
H --> H1[404/500 错误 -> 查 Tomcat logs/resin.log]
H --> H2[JS 报错 -> 清理缓存/检查 Ecode]
2. 常见问题排查表
| 故障现象 | 可能原因 | 排查命令/操作 | 解决方案 |
|---|---|---|---|
| 白屏/加载转圈 | 浏览器缓存 / JS 报错 | 浏览器无痕模式测试 | Ctrl+F5 强制刷新；清理浏览器缓存 |
| 流程提交卡死 | 数据库锁 / 触发器报错 | 查 workflow_requestbase 状态 |
联系开发检查 Action/插件日志；重启 Tomcat |
| 附件上传失败 | 磁盘满 / 临时目录权限 | df -h 检查磁盘 |
清理磁盘空间（见容量管理）；检查 /tmp 权限 |
| 登录报错“用户不存在” | LDAP/AD 同步失败 / 账号锁定 | 查数据库 hrmresource |
检查账号状态字段 status；重设密码 |
| 移动端无法连接 | 网关配置错误 / Caddy 未转发 | curl -I https://oa.hynn.com.cn/mobile |
检查 Caddy 配置；确认 443 端口对外开放 |
| 报表数据不更新 | 报表计划任务未执行 | 检查报表调度日志 | 重新启用报表调度；手动执行一次调度 |
3. 核心日志文件位置
- Tomcat 主日志：
/weaver/ecology/log/ecology.log(或catalina.out) - Ecode 日志：
/weaver/ecology/log/ecode.log - 数据库日志：SQL Server Error Log 或 MySQL
error.log - Web 服务器：Caddy
journalctl -u caddy` - 数据库日志：SQL Server Error Log 或 MySQL
error.log - Web 服务器：Caddy
journalctl -u caddy## 4. 紧急自救三板斧
如果系统彻底瘫痪且找不到原因，尝试标准重启顺序：
1. 重启 Tomcat: systemctl restart ecology (具体服务名视安装而定)
2. 重启 Caddy: systemctl restart caddy
3. 释放内存: sync && echo 3 > /proc/sys/vm/drop_caches (慎用)