存在Unicode值时出现Hash不匹配问题求助

问题背景 #

模块间通过RestTemplate发起HTTP调用，调用方基于请求参数生成HMAC-SHA256哈希并放入请求头，被调用方重新计算哈希验证一致性。测试环境验证正常，但生产环境仅当参数包含Unicode字符时出现哈希不匹配。已尝试添加UTF-8编码的StringHttpMessageConverter，问题仍未解决，且Java、Tomcat版本等环境配置与测试环境一致。

核心排查与解决方向 #

1. 确保参数序列化/解码全程UTF-8一致 #

• 调用方侧：若参数通过URL传递，需显式用URLEncoder.encode(param, StandardCharsets.UTF_8.name())处理Unicode参数，避免依赖系统默认编码导致转码差异；若为JSON请求体，确认序列化工具（如Jackson）强制使用UTF-8编码。
• 被调用方侧：检查Tomcat的server.xml中Connector节点是否显式配置URIEncoding="UTF-8"，避免URL参数解码时使用系统默认编码；获取请求体时，确保用request.getInputStream()读取后按UTF-8转字符串，而非依赖request.getParameter()的隐式编码。

2. 哈希计算的原始字符串必须完全一致 #

• 调用方和被调用方需打印用于计算哈希的原始字符串字节数组十六进制值（生产环境可临时日志输出，注意脱敏），对比是否存在字符转义、空格、换行符或参数顺序差异——哈希计算对字符串的字节序列完全敏感，任何细微差异都会导致结果不同。
• 统一哈希计算的字节转换逻辑：双方必须使用string.getBytes(StandardCharsets.UTF_8)将字符串转字节数组，禁止依赖string.getBytes()（默认使用JVM系统编码）。

3. 确认RestTemplate消息转换器的优先级与配置 #

添加StringHttpMessageConverter到首位后，需验证是否被其他转换器覆盖：

// 打印转换器顺序，确认StringHttpMessageConverter排在第一位
restTemplate.getMessageConverters().forEach(System.out::println);

若为JSON请求，需同步配置Jackson转换器的UTF-8编码：

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.setCharset(StandardCharsets.UTF_8);
MappingJackson2HttpMessageConverter jacksonConverter = new MappingJackson2HttpMessageConverter(objectMapper);
// 替换或添加到转换器首位
restTemplate.getMessageConverters().set(0, jacksonConverter);

4. 排查生产环境中间件的干扰 #

即使基础环境配置一致，生产环境的代理、网关（如Nginx、API网关）可能修改请求：

• 检查中间件是否对Unicode字符做了自动转义（如将\uXXXX转为实体编码或反之），或修改了请求参数的编码格式；
• 验证JVM启动参数，确保生产环境添加了-Dfile.encoding=UTF-8，统一JVM默认编码。

快速验证步骤 #

1. 用curl或Postman直接向生产环境的被调用方发起请求，携带测试环境验证通过的参数和哈希，确认是否匹配——排除调用方RestTemplate的序列化问题；
2. 在调用方和被调用方分别输出原始字符串的字节数组十六进制值，对比是否完全一致。

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