Groovy DSL Spring Cloud Contract含Unicode查询参数抛出IllegalStateException异常

报错中出现的Êdward Jõhnson被转成Êdward Jõhnson，是UTF-8字节流被按ISO-8859-1单字节规则错误解码的典型特征：

• 字符Ê的UTF-8编码为双字节0xC3 0x8A，如果按ISO-8859-1逐字节解码，两个字节会分别映射为Ã和Š，最终拼出Ê
• 字符õ的UTF-8编码为双字节0xC3 0xB5，按同样的错解码规则就会变成õ

整个错配发生在Spring Cloud Contract的全链路处理流程中：框架从Groovy契约读取参数值、生成测试请求、构建响应校验的JSONPath规则、解析实际响应内容的各个环节，没有统一强制使用UTF-8编解码，默认沿用了运行环境的平台默认编码（多数Linux服务器环境默认ISO-8859-1），最终导致校验时的期望值和实际返回值出现编码偏差，触发匹配失败。

• 全局统一运行环境的默认编码
  所有执行契约测试的环境（本地开发机、CI流水线、构建服务），必须强制指定JVM、构建工具的默认文件编码为UTF-8，不能依赖系统默认编码：
  • 给测试执行任务追加JVM启动参数：-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8。例如Gradle项目可在test配置块中通过jvmArgs追加该参数，Maven项目在surefire插件的配置中添加对应系统属性
  • 确认保存Groovy契约文件的编码为UTF-8，不要使用GBK、ISO-8859-1等其他编码保存，避免契约解析阶段就读错字符值
• 修正契约内的参数值构造逻辑
  之前两种传入Unicode值的写法失效，本质是依赖Groovy解析字符串时的默认编码，没有强制走UTF-8：
  • 替换参数值的构造方式，显式通过UTF-8字符集构造字符串，绕开默认编码的影响：将原来的p('Êdward Jõhnson')调整为p(new String('Êdward Jõhnson'.getBytes(StandardCharsets.UTF_8), StandardCharsets.UTF_8))，保证字符串从构造到存储全程使用UTF-8编码
  • 同步修正请求query参数的URL编码规则，不要让框架使用默认的ISO-8859-1做URL转码，指定query参数的编码为UTF-8
• 调整响应校验的解析规则
  • 不要依赖fromRequest().query("name")做跨环节的值透传校验，这个透传链路会经过URL编码、请求转发、响应回传多个环节，每一个环节都可能出现编码错配；可以直接在响应body的name字段定义里，和已规范化的UTF-8期望值做精确匹配，替代透传逻辑
  • 强制指定响应JSON解析环节的字符集为UTF-8，避免实际返回的UTF-8字节流被错解为其他编码，和期望值形成偏差
• 修复验证
  调整完成后触发测试时，可检查控制台打印的实际JSONPath校验规则，确认期望值已经是正确的Êdward Jõhnson，不再出现Ê、õ类的乱码，即可完成匹配。

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