背景

区分 UTF-8 和 GBK

GBK 是在国家标准 GB2312 基础上扩容后兼容 GB2312 的标准，专门用来解决中文编码的，是双字节的，不论中英文都是双字节的。

UTF-8 是一种国际化的编码方式，包含了世界上大部分的语种文字（简体中文字、繁体中文字、英文、日文、韩文等语言），也兼容 ASCII 码。

虽然 GBK 比 UTF-8 少节省两个字节，但是 GBK 只包含中文，UTF-8 包含全世界所有国家需要用到的字符，所以现在很多系统或者框架处理都默认使用 UTF-8 。

不过业务开发对接系统接口的时候，经常会碰到一些老系统使用 GBK 编码，特别是国内支付，这个时候需要兼容 GBK 和 UTF-8 编码。

如何让项目兼容 UTF-8 和 GBK

我们使用 spring boot 2.7 版本。我们默认API使用 UTF-8 ，特别的 API 使用 GBK。在 spring boot 中，当收到请求解析前会通过 CharacterEncodingFilter 进行内容编码格式指定。

    @Override    protected void doFilterInternal(            HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)            throws ServletException, IOException {        String encoding = getEncoding();        if (encoding != null) {      // 请求进来设置编码（设置了请求强制转编码或请求头未设置编码时）            if (isForceRequestEncoding() || request.getCharacterEncoding() == null) {                request.setCharacterEncoding(encoding);            }      // 设置了响应强制转编码            if (isForceResponseEncoding()) {                response.setCharacterEncoding(encoding);            }        }        filterChain.doFilter(request, response);    }

通过以下方式可以修改项目全局的编码方式

server:  servlet:    encoding:      charset: UTF-8      force-request: false      force-response: false

看下默认情况下，编码格式 UTF-8 并且每次都强制转换，什么意思？也就是说就算你请求头 application/json;charset=GBK 这样也不会按照头上的编码解析，会强制给你转成 UTF-8，如果是 GBK 过来的内容，你就等着吃乱码吧！

    @Bean    @ConditionalOnMissingBean    public CharacterEncodingFilter characterEncodingFilter() {        CharacterEncodingFilter filter = new OrderedCharacterEncodingFilter();        filter.setEncoding(this.properties.getCharset().name());        filter.setForceRequestEncoding(this.properties.shouldForce(Encoding.Type.REQUEST));        filter.setForceResponseEncoding(this.properties.shouldForce(Encoding.Type.RESPONSE));        return filter;    }public boolean shouldForce(Type type) {        Boolean force = (type != Type.REQUEST) ? this.forceResponse : this.forceRequest;        if (force == null) {            force = this.force;        }        if (force == null) {            force = (type == Type.REQUEST);        }        return force;    }

现在有一个支付系统，它请求的内容为 GBK 编码，并且有 GET 和 POST 两种方式过来，我们系统接口默认是 UTF-8，所以只有针对特定的 GBK 接口进行处理。需要支持下面几种请求情况。

POST 对方的请求内容 GBK 编码并且请求头里指定了编码方式 application/json;charset=GBK。POST 对方的请求内容 GBK 编码并且请求头里未指定编码方式 application/json。GET 对方的请求内容 GBK 编码。

第一种情况，我们只需要关闭强制转换，带了charset=gbk，就会使用 gbk 编码进行解析，默认不带则使用 utf-8 解析。

server:  servlet:    encoding:            force: false

第二种和第三种情况，我们需要先关闭强制转换，然后添加一个优先级很高的过滤器将指定的请求设置为 GBK 编码格式（也就是在进入spring 解析前就要处理），如果使用 tomcat 容器的话如下处理。

@Slf4j@Configurationpublic class GBKFilterConfig {    @Bean    public FilterRegistrationBean gbkFilter() {        FilterRegistrationBean registration = new FilterRegistrationBean();        registration.setDispatcherTypes(DispatcherType.REQUEST);        registration.setFilter(new Filter() {            @Override            public void init(javax.servlet.FilterConfig filterConfig) throws ServletException {            }            @Override            public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)                    throws IOException, ServletException {                RequestFacade req = (RequestFacade) request;                Class clazz = req.getClass();                log.info("GBK Filter...");                try {                    Field field = clazz.getDeclaredField("request");                    field.setAccessible(true);                    Request r = (Request) field.get(req);                    org.apache.coyote.Request p = r.getCoyoteRequest();                    // GET 请求参数强使用 GBK 编码。                    p.getParameters().setQueryStringCharset(Charset.forName("GBK"));                    // POST 请求带头未指定编码，强制使用 GBK                    p.getParameters().setCharset(Charset.forName("GBK"));                    p.setCharset(Charset.forName("GBK"));                    chain.doFilter(request, response);                } catch (Exception e) {                   log.error("error", e)                }            }            @Override            public void destroy() {            }        });        registration.addUrlPatterns("/api/gbk/**");        registration.setName("gbkFilter");        registration.setOrder(Integer.MIN_VALUE);        return registration;    }}