日志与故障排查
系统问题诊断依赖 应用日志、计划任务日志 与 Espo 官方排查清单。
参考：
应用日志
管理 → 应用日志（App Log）
或服务器文件：data/logs/espo-YYYY-MM-DD.log
开启 Debug
data/config.php：
'logger' => [
'level' => 'DEBUG',
],
排查后改回 WARNING 或 ERROR，避免日志暴涨。
常见故障
白屏 / 500
- 看
data/logs/最新 log - 管理 → Rebuild 或
php rebuild.php - 清除缓存
- 检查 PHP 版本、扩展（mysqli、zip、gd…）→ 管理 → 系统要求
安装扩展后菜单乱/报错
- Rebuild + 清除缓存
- 确认 Espo 版本 ≥ 9.1
- 确认 ForeignTrade zip 与版本匹配
邮件问题
PDF 中文乱码
- PDF 模板 Style 含中文字体
stsongstdlight - 产品名用
<span lang="zh-CN">
Excel 占位符未替换
权限 / 专业版功能不可用
- Bring外贸专业版许可 是否激活
- 角色 scope 是否开放
- 免费版无法使用财务、Excel、备份等
WebSocket / 通知
导入失败
- 导入结果页看错误行
- ImportTemplate 列映射是否匹配文件
计划任务失败
管理 → 计划任务 → 打开失败任务 → 查看 Log 链接。
Bring 备份失败：通知内容 + zip 内 backup-report.txt。
数据库
管理 → 数据库备份（Espo 原生）与 Bring 业务备份是两套机制，见 Espo 原生备份 与 Bring 备份。
获取支持
- 导出相关 log 片段（勿含密码）
- 说明 Espo 版本、Bring 扩展版本、复现步骤
- 官网 联系我们