OroCRM CSV联系人导入功能失效如何排查解决？

问题前置排查 #

• 登录系统后进入右上角 系统 菜单，选择 作业队列 页
• 匹配导入操作的时间点，找到类型为 import 的对应任务，查看执行状态：
  • 状态为失败：点击任务条目可查看具体报错日志，常见错误包括CSV编码非UTF-8、必填字段为空、字段格式不匹配（如邮箱/手机号格式错误）、关联字段（如所属客户）未提前录入系统
  • 状态为待处理/新建：说明系统消息队列未启动，需在服务端执行命令 php bin/console oro:message-queue:consume --env=prod 启动队列消费，单次测试可加参数 --limit=10 执行完指定数量任务后自动退出

标准化导入操作步骤（新手通用） #

• 导出对应实体的官方模板：例如导入联系人需先进入 客户-联系人 列表页，点击右上角 导入 按钮，在弹窗中选择 下载数据模板，不要混用不同实体的导入模板，各实体字段规则完全不同
• 填写模板需符合以下规则：
  • 表头字段的顺序、名称不得修改
  • 带*标识的必填字段不得留空
  • 字段值不要添加多余空格、换行符或特殊符号
  • 日期字段统一使用 YYYY-MM-DD 格式，时间字段使用 HH:MM:SS 格式
  • 枚举类字段（如联系人来源、优先级）只能填写系统预设的选项值，不得自定义内容
• 编辑完成后将文件保存为UTF-8编码的CSV格式
• 回到导入弹窗，上传编辑好的文件，勾选发送导入结果通知选项后提交
• 提交后等待1-3分钟（依数据量大小调整），可刷新作业队列确认执行结果，执行完成后到对应实体列表页按创建时间倒序排序即可查看新增记录

其他无通知无记录的常见原因 #

• 邮件配置异常：若任务状态显示成功但未收到通知邮件，可进入 系统-配置-邮件设置 页发送测试邮件，验证SMTP配置是否正常
• 权限不足：当前登录账号无新增数据的查看权限，可使用管理员账号登录确认记录是否存在

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