MyBatis-Plus分页参数current字段的编码问题分析与解决方案

问题背景

在使用MyBatis-Plus进行分页查询时，开发者发现当通过GET请求传递分页参数时，URL中的current=1参数在某些情况下会被错误编码为"20¤t=1"，导致后端无法正确解析分页参数。这个问题源于current字段名称的特殊性，在某些字符编码环境下会被错误处理。

问题本质分析

1. 字符编码问题：current中的cur部分在某些字符集(如ISO-8859-1)中会被识别为货币符号¤的编码，导致参数传递异常。

2. 框架设计考量：MyBatis-Plus的Page类直接使用current作为当前页码的字段名，虽然语义明确，但忽略了Web开发中URL参数传递可能遇到的编码问题。

3. 开发实践影响：许多开发者(包括一些代码生成工具)习惯直接使用框架提供的Page类作为Controller层的参数接收对象，这放大了潜在的问题影响范围。

解决方案探讨

方案一：自定义分页参数类(推荐)

public class MyPageParam {
    private Integer pageNum;  // 使用更安全的字段名
    private Integer pageSize;
    
    // 转换为MyBatis-Plus的Page对象
    public <T> Page<T> toPage() {
        return new Page<>(pageNum, pageSize);
    }
}

优点：

• 完全解耦与框架的具体实现
• 字段命名可控，避免编码问题
• 便于扩展自定义分页逻辑

方案二：配置URL编码过滤器

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Bean
    public FilterRegistrationBean<CharacterEncodingFilter> encodingFilter() {
        FilterRegistrationBean<CharacterEncodingFilter> bean = new FilterRegistrationBean<>();
        bean.setFilter(new CharacterEncodingFilter());
        bean.addInitParameter("encoding", "UTF-8");
        bean.addInitParameter("forceEncoding", "true");
        bean.addUrlPatterns("/*");
        return bean;
    }
}

适用场景：当必须使用框架Page类且无法修改现有代码结构时。

方案三：全局参数转换器

@ControllerAdvice
public class PageParamAdvice {
    @InitBinder
    public void initBinder(WebDataBinder binder) {
        binder.registerCustomEditor(Page.class, new PropertyEditorSupport() {
            @Override
            public void setAsText(String text) {
                // 自定义参数解析逻辑
            }
        });
    }
}

最佳实践建议

1. 避免直接暴露框架类：Controller层应使用自定义的参数类，在Service层转换为框架需要的类型。

2. 统一编码规范：项目应明确规定分页参数的命名规范(如使用pageNum/pageNo等替代current)。

3. 代码生成工具定制：如果使用代码生成工具，应修改其模板以生成符合项目规范的分页代码。

4. 接口文档明确说明：在API文档中清晰定义分页参数的名称和格式要求。

总结思考

这个看似简单的编码问题实际上反映了框架使用中的一个重要原则：框架提供的类更适合作为内部实现细节，而非对外接口契约。MyBatis-Plus的Page类设计初衷是作为分页查询的内部实现工具，而非Web层的参数接收对象。

通过这个案例，开发者应该建立以下认知：

1. 框架类与业务接口应当有明确的边界
2. 参数命名需要考虑各种传输场景的兼容性
3. 代码生成工具的输出应该经过项目化定制
4. 字符编码问题需要从全局配置层面解决

遵循这些原则，可以有效避免类似的分页参数问题，构建更健壮的系统。