SAP至MuleSoft SAP函数监听器的编码问题排查与解决咨询

问题详情 #

SAP发出的负载内容：

<LAST_NAME>exampleć</LAST_NAME>

MuleSoft SAP函数监听器接收到的负载变为：

<LAST_NAME>example#</LAST_NAME>

其他特殊字符（如ä、ü、ö、ç）可正常处理，仅ć出现替换问题。

现有配置信息 #

<sap:function-listener doc:name="Function listener" doc:id="54a4bb95-3a7e-477e-b3e9-c9438ecb222e" 
    config-ref="SAP_Config" gatewayHost="${sap.gwhost}" gatewayService="${sap.gwserv}" 
    programID="${sap.progid}" connectionCount="${sap.connection_count}" 
    targetedFunction="${sap.rfcFunction}">
</sap:function-listener>

<sap:sap-config name="SAP_Config" doc:name="SAP Config" doc:id="f6913aeb-d17c-4f5f-b785-c896e9ab8cc9">
    <sap:simple-connection-provider-connection username="${sap.user}" 
        password="${secure::sap.password}" systemNumber="${sap.sysnr}" 
        client="${sap.client}" applicationServerHost="${sap.ahost}"/>
</sap:sap-config>

成因分析 #

• 字符集映射不兼容：SAP侧使用的字符集（如CP1252）与MuleSoft SAP监听器默认处理的字符集对ć的映射规则不一致，ć在目标字符集中无对应编码，被系统以占位符#替代
• RFC通信字符转换配置缺失：SAP RFC网关或MuleSoft监听器未显式配置字符集转换规则，导致特定字符无法被正确解析转换
• 字段类型/长度限制：SAP中对应LAST_NAME字段若为固定长度CHAR类型，字符转换时ć的字节长度超出字段预期容量，被截断替换为占位符

解决思路 #

1. 统一字符集配置 #

• 在SAP侧确认RFC发送使用的字符集：通过事务码SMLG、RZ10查看系统参数zcsa/system_locale、install/codepage，确定当前使用的编码（如CP1252对应编码值1252，UTF-8对应4110）
• 在MuleSoft的SAP_Config中显式指定匹配的字符集编码，添加codePage属性：

  <sap:sap-config name="SAP_Config" doc:name="SAP Config" doc:id="f6913aeb-d17c-4f5f-b785-c896e9ab8cc9">
      <sap:simple-connection-provider-connection username="${sap.user}" 
          password="${secure::sap.password}" systemNumber="${sap.sysnr}" 
          client="${sap.client}" applicationServerHost="${sap.ahost}" codePage="1252"/>
  </sap:sap-config>
  

2. 验证SAP RFC字段定义 #

• 通过事务码SE37检查目标RFC函数的LAST_NAME字段：
  • 若为CHAR类型，确认字段长度是否足够容纳ć的字节数（CP1252中ć占1字节，UTF-8中占2字节），必要时调整字段长度
  • 考虑将字段类型改为STRING类型，避免固定长度限制导致的字符截断

3. 检查连接器版本并升级 #

• 确认当前MuleSoft SAP Connector版本是否存在字符转换相关的已知Bug，尝试升级至最新稳定版本，修复潜在的编码处理问题

4. 启用日志排查 #

• 在SAP侧通过事务码SM59开启RFC目标的字符转换日志，追踪发送过程中的编码转换细节
• 在MuleSoft侧开启SAP连接器的调试日志，查看接收端字符解析的具体错误信息，定位问题节点

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