如何排查Mule4中SOQL执行报SALESFORCE:INVALID_INPUT错误的问题

可能的诱因 #

• Salesforce PRD环境中Mule集成使用的账号，对specification__c对象或SOQL中用到的自定义字段存在字段级权限限制，通过API访问时触发校验报错，而Salesforce团队测试时使用的是高权限账号，因此直接执行SOQL无异常
• 生产环境部署时的配置占位符替换逻辑存在异常，导致SOQL中的动态参数被错误替换，最终生成的SOQL不符合语法要求
• Mule PRD服务器的系统时区、字符集配置与QA环境不一致，导致代码中动态生成的日期时间参数实际值与预期不符，最终拼接出的SOQL存在语法错误
• Mule PRD环境部署的Salesforce连接器版本、配置的API版本与QA环境存在差异，不同版本的连接器对日期时间格式的序列化规则不一致
• Salesforce PRD实例启用了针对API入站请求的额外SOQL校验规则，例如特殊字符转义、查询行数限制校验等，与QA环境配置不同

根因定位方法 #

• 开启Mule PRD环境Salesforce连接器的DEBUG级别日志，捕获实际发往Salesforce的完整请求内容、请求头以及返回的全量错误信息，和QA环境的正常请求做逐字符对比，确认SOQL内容、请求格式是否完全一致。优先执行该操作，绝大多数参数类差异都可以通过该步骤发现
• 从日志中提取Mule实际发送的SOQL语句，使用Mule集成对应的同一个Salesforce账号，在Salesforce PRD的开发者控制台中执行，确认是否可以正常返回结果，排除账号权限、字段权限差异问题
• 核对Mule PRD与QA环境的系统配置：包括服务器操作系统时区、默认字符集、Salesforce连接器版本、连接器配置的Salesforce API版本、连接参数等，确认所有配置项完全对齐
• 检查Salesforce PRD与QA环境中specification__c对象的所有字段定义、权限配置，以及实例级的API安全规则，确认是否存在配置差异

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