跳转至

日志与故障排查

系统问题诊断依赖 应用日志、计划任务日志 与 Espo 官方排查清单。

参考：

应用日志

管理 → 应用日志（App Log）

或服务器文件：data/logs/espo-YYYY-MM-DD.log

开启 Debug

data/config.php：

'logger' => [
    'level' => 'DEBUG',
],

排查后改回 WARNING 或 ERROR，避免日志暴涨。

常见故障

白屏 / 500

  1. 看 data/logs/ 最新 log
  2. 管理 → Rebuild 或 php rebuild.php
  3. 清除缓存
  4. 检查 PHP 版本、扩展（mysqli、zip、gd…）→ 管理 → 系统要求

安装扩展后菜单乱/报错

  1. Rebuild + 清除缓存
  2. 确认 Espo 版本 ≥ 9.1
  3. 确认 ForeignTrade zip 与版本匹配

邮件问题

见 邮件系统、邮件群发 故障表。

PDF 中文乱码

  • PDF 模板 Style 含中文字体 stsongstdlight
  • 产品名用 <span lang="zh-CN">

Excel 占位符未替换

见 Excel 单证模板

权限 / 功能不可用

按以下顺序排查（多数为角色权限或导航，不是许可）：

  1. 管理 → 角色 → 对应实体 scope 是否 全部/团队/本人 至少可读
  2. 用户是否分配了正确角色
  3. 菜单是否在 More 或被 导航栏 隐藏
  4. 极少见 — 许可失效：整站（含 admin）同类功能均不可用 → 管理 → Bring外贸 → 许可，或联系部署方

财务实体权限与导航详见 财务与利润、设置权限。

WebSocket / 通知不实时

  1. Docker 环境确认 espocrm-daemon 容器运行（Cron / 队列）
  2. WebSocket 配置与端口 → WebSocket
  3. 个人邮箱 IMAP → 绑定个人邮箱；出站 SMTP → 邮件系统

导入失败

  • 导入结果页看错误行
  • ImportTemplate 列映射是否匹配文件

计划任务失败

管理 → 计划任务 → 打开失败任务 → 查看 Log 链接。

Bring 备份失败：通知内容 + zip 内 backup-report.txt。

数据库

管理 → 数据库备份（Espo 原生）与 Bring 业务备份是两套机制，见 Espo 原生备份 与 Bring 备份。

获取支持

  1. 导出相关 log 片段（勿含密码）
  2. 说明 Espo 版本、Bring 扩展版本、复现步骤
  3. 官网 联系我们

相关文档

← Espo 平台配置概述