JeecgBoot/JimuReport API数据集排序参数传递问题解析

问题背景

在JeecgBoot/JimuReport报表系统的1.9.3版本中，用户反馈了一个关于API数据集排序功能的技术问题。当用户在前端配置了自定义表格标题排序(customTableTitleSorts)后，发现这些排序参数无法正确传递到后端服务，导致排序功能无法正常工作。

问题现象

用户在使用API数据集时，设置了自定义的表格标题排序参数。通过调试发现：

1. 初始设置的非默认排序参数（指定字段的升序/降序）在前端请求参数中表现为空数组
2. 只有通过点击页面上的排序小三角图标时，customTableTitleSorts参数才会有正确的值
3. 即使参数在前端显示正确，后端服务仍然无法获取到这些排序参数

技术分析

经过开发团队排查，发现这是一个参数传递和解析的问题。根本原因在于：

1. API接口在接收排序参数时，需要对URL编码的参数进行解码处理
2. 前端传递的排序参数可能采用了URL编码格式，而后端没有进行相应的解码处理
3. 直接点击排序图标能正常工作的原因是系统内部处理了这部分逻辑，而自定义排序走的是另一条参数传递路径

解决方案

该问题已在后续版本中得到修复，主要改进点包括：

1. 后端服务增加了对URL编码参数的自动解码处理
2. 统一了自定义排序和点击排序的参数传递机制
3. 确保所有排序参数都能正确传递到后端服务

对于使用1.9.3版本的用户，可以采取以下临时解决方案：

1. 在后端接口中手动对接收到的排序参数进行URL解码
2. 检查前端传递的参数格式，确保符合后端接口的预期

最佳实践建议

为了避免类似问题，建议开发者在处理API参数时：

1. 明确前后端参数传递的编码规范
2. 对关键功能参数进行端到端测试
3. 在接口文档中清晰标注参数是否需要编码/解码
4. 考虑使用统一的参数处理中间件来保证参数解析的一致性

总结

这个案例展示了在前后端分离架构中，参数传递和处理细节的重要性。即使是看似简单的排序功能，也需要前后端的密切配合和统一的参数处理机制。JeecgBoot/JimuReport团队通过修复这个问题，进一步提升了产品的稳定性和用户体验。