【exception】Could not read document Invalid UTF-8 middle byte 0x3f_could not read document: invalid utf-8 middle byte-优快云博客

本文链接：https://blog.youkuaiyun.com/ColdFireMan/article/details/84307795

本文记录了一次解决因未指定字符集导致的UTF-8编码异常问题的过程。在将项目部署到Windows Server后，页面操作出现异常，通过分析发现是过滤器中处理POST请求时未指定字符集所致。通过在过滤器中明确指定UTF-8字符集，成功解决了该问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

今天开发完功能后打包部署到服务器后页面操作出现这个问题，花了点时间分析解决了，记录一下

问题描述

在本地开发测试的时候没有问题，但是打成jar包放到windows server运行后，在页面点击，调用接口抛出了这个异常。一开始以为是数据库中出现了特殊字符，用本地连接测试数据库发现没有问题，所以不是数据库的问题。所以分析是前后端编码和解码的问题。
F12检查发现前端发送的是UTF-8的数据，后端也是按照UTF-8解析的，似乎没有问题。但是想到自己刚放上去一个日志记录相关的过滤器和拦截器，大致定位是在这个位置的问题。
过滤器中有一个操作是从POST请求的流中获取到请求json，然后设置一个新的流返回，这样后面的controller才能获取到RequestBody。所以基本定位就是在重新设置流的时候没有指定字符集，导致这里的流在springmvc解析参数的时候抛出了这个异常。

解决

原来这个代码是在网上找的，目的是为了获取POST中的参数：

@Override
    public ServletInputStream getInputStream() throws IOException {
        final ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(body.getBytes());
        ServletInputStream servletInputStream = new ServletInputStream() {
            @Override
            public boolean isFinished() {
                return true;
            }

            @Override
            public boolean isReady() {
                return true;
            }

            @Override
            public void setReadListener(ReadListener readListener) {

            }

            public int read() throws IOException {
                return byteArrayInputStream.read();
            }
        };
        return servletInputStream;
    }

上面的部分中，body是之前解析出来的json字符串，这里body.getBytes()是重新获取这个json的字节数组设置输入流。因为这里没有指定字符集，导致了以上的问题。
修改后：

@Override
    public ServletInputStream getInputStream() throws IOException {
        // 这里指定字符集，问题解决
        final ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(body.getBytes("UTF-8"));
        ServletInputStream servletInputStream = new ServletInputStream() {
            @Override
            public boolean isFinished() {
                return true;
            }

            @Override
            public boolean isReady() {
                return true;
            }

            @Override
            public void setReadListener(ReadListener readListener) {

            }

            public int read() throws IOException {
                return byteArrayInputStream.read();
            }
        };
        return servletInputStream;
    }