GET请求传递对象获取Thymeleaf渲染HTML时URL过长报错如何解决

优先推荐：改用POST请求 #

GET请求的设计定位本身不支持传递大量复杂参数，改用POST请求是最低成本的解决方案：

• 直接将渲染所需的序列化JSON放到POST请求体中传输，完全避开URL长度限制问题
• 不需要额外处理特殊字符转义，请求体传输JSON不需要做URL编码，不会出现{}等特殊字符导致的报错
• 服务间调用场景下不需要考虑GET专属的浏览器书签、缓存、搜索引擎收录等限制，适配性极强
• 可以直接复用你已经实现的参数序列化、反序列化逻辑，开发量极小

必须保留GET请求的兼容方案 #

如果受框架规则、合规要求限制必须使用GET接口，可以按以下步骤处理：

• 首先对序列化后的JSON字符串做URL编码，即可解决特殊字符报错问题，Java生态可直接调用URLEncoder.encode(jsonParam, StandardCharsets.UTF_8.name())实现编码，请求接收端对应做URL解码即可
• 对JSON做压缩处理：移除序列化后的空格、换行符，必要时用短键名替换原始字段名，尽可能压缩参数长度
• 如果压缩后参数长度仍然超出URL限制，可以增加参数缓存逻辑：调用方先将完整渲染参数上传到服务端缓存，获取一个唯一的字符串ID，仅将该ID作为GET查询参数传递，渲染接口通过ID从缓存中取出完整参数完成渲染，缓存可设置短过期时间（如5分钟）满足实时性要求

业务适配优化建议 #

你可以直接复用原有服务的Thymeleaf模板渲染逻辑，新增接口仅截断后续PDF转换的步骤，直接返回渲染完成的HTML字符串即可，既减少重复开发，也能保证HTML渲染结果和原有PDF生成时的模板内容完全一致，避免两端渲染差异问题。

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