消息发送时出现的乱码问题及解决方案

需求

在现有的系统管理端增加一个定时任务，用于检查即将过期的授权公司，调用api接口进行消息通知

乱码问题

主体业务逻辑完成后进行测试，发送出去的消息在明确指定采用UTF-8编码的情况下仍然出现了中文乱码问题

乱码时消息发送SendWxByJobno类主体部分如下：

    private final String url = "http://......";//第三方接口，已注释

    private RestTemplate restTemplate;

    public SendWxByJobno(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    public void sendNotification(String jobno, String message) {//严格按照了第三方消息发送接口的调用文档进行编写

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        headers.setAcceptCharset(Collections.singletonList(StandardCharsets.UTF_8));

        // 构建参数
        String requestBody = "{\"jobno\":\"" + jobno + "\",\"message\":\"" + message + "\"}";
        System.out.println("Request Body: " + requestBody);

        HttpEntity<String> entity = new HttpEntity<>(requestBody, headers);

        try {
            ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
            HttpStatus statusCode = response.getStatusCode();

            System.out.println("Status Code: " + statusCode);//控制台打印测试

            if (statusCode.is2xxSuccessful()) {
                System.out.println("消息发送成功");
            } else {
                String errorMessage = response.getBody();
                System.err.println("消息发送失败: " + errorMessage);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

原因分析

当参数直接使用对象时，Spring框架会自动将对象序列化为JSON格式，并在HTTP请求的请求体中以JSON格式发送给目标服务器，序列化的整个过程由Spring框架内部完成，通常会使用UTF-8编码来确保字符的正确性，在这种情况下，不会出现乱码的情况

而当参数转换为JSON字符串后，如果不正确地指定了字符编码，或者在HTTP请求中未正确地设置字符编码，就有可能导致乱码的问题。虽然在代码中已经明确指定了使用UTF-8编码，但是如果在HTTP请求头中没有正确地指定编码，或者接收方未正确地解析编码，就有可能导致乱码的问题（本文是后者）

解决方案

参数直接使用对象，而不转换成json字符串

    private final String url = "http://......";//第三方接口，已注释

    private RestTemplate restTemplate;

    public SendWxByJobno(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    public void sendNotification(String jobno, String message) {
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        headers.setAcceptCharset(Collections.singletonList(StandardCharsets.UTF_8));

        // 构建参数对象
        WxMessage wxMessage = new WxMessage(jobno, message);

        HttpEntity<WxMessage> entity = new HttpEntity<>(wxMessage, headers);

        try {
            ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
            HttpStatus statusCode = response.getStatusCode();

            System.out.println("Status Code: " + statusCode);

            if (statusCode.is2xxSuccessful()) {
                System.out.println("消息发送成功");
            } else {
                String errorMessage = response.getBody();
                System.err.println("消息发送失败: " + errorMessage);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    // 参数对象类
    private static class WxMessage {
        
        //构造相应的参数对象类
    }