Vtiger 7.1.0工单触发邮件未发送问题排查咨询

我来帮你梳理下这种场景下的常见问题，毕竟在Vtiger运维中经常碰到类似情况：

• 定时任务（Cron Job）未正常执行
  Vtiger的工作流任务队列依赖cron.php脚本定期触发执行，不是实时推送的。你需要：

  1. 检查服务器上的Cron配置是否添加了Vtiger的定时任务，示例命令：

     * * * * * php -f /var/www/html/vtiger/cron.php > /dev/null 2>&1
     

  2. 手动执行一次php -f /path/to/vtiger/cron.php，观察是否有报错输出，同时查看Cron日志确认任务是否按时运行。

• SMTP邮件服务器配置失效
  虽然你配置了外发邮件，但实际发送时可能存在连通性问题：

  • 用Vtiger后台的「邮件设置」→「测试连接」功能验证SMTP服务器是否能正常连通，重点检查端口（25/587/465）、SSL/TLS开关、用户名密码是否正确（比如Gmail需要用应用专用密码）。
  • 查看Vtiger的日志文件（storage/logs/目录下的日志），搜索SMTP或mail关键字，定位是否有连接超时、认证失败等错误。

• 工作流配置存在疏漏

  • 触发条件：确认工作流的触发规则是否严格匹配，比如是否额外添加了字段条件（如特定工单状态、优先级）导致创建工单时未触发。可以先简化条件为仅「当工单创建时」再测试。
  • 邮件动作：检查收件人配置是否正确，比如是否选择了正确的字段（如联系人邮箱、用户邮箱），有没有使用错误的变量格式（正确格式应为$fieldname$）；同时确认邮件模板没有语法错误，避免因模板问题导致邮件无法生成。

• 任务队列记录异常
  查看com_vtiger_workflowtask_queue表的status字段：

  • 如果是failed，直接查看error字段的内容，里面会记录具体失败原因（如SMTP认证错误、收件人无效等）。
  • 如果是ready但一直未执行，大概率是Cron任务未正常运行导致的。

• 权限与用户状态限制

  • 工作流关联的执行用户是否有「发送邮件」的权限，且该用户账号处于启用状态。
  • 目标收件人的邮箱是否在Vtiger中被标记为「无效」，或者用户设置了拒收邮件。

• 服务器环境配置限制

  • 检查PHP配置：确认openssl扩展已启用（用于SSL/TLS连接），allow_url_fopen已开启，max_execution_time设置足够长（避免Cron执行超时）。
  • 服务器防火墙是否拦截了SMTP端口的出站请求，比如部分主机商会禁用25端口，建议改用587或465端口。

内容的提问来源于stack exchange，提问作者John Doe