使用RestTemplate调用Chatbase接口报500未知服务器错误求助

我之前对接Chatbase API的时候也踩过这个坑！问题出在你请求体的序列化方式上——虽然你设置了Content-Type: application/json，但用LinkedMultiValueMap作为请求体的话，RestTemplate默认会把它当成表单数据（application/x-www-form-urlencoded）来处理，而Chatbase的API只接受JSON格式的请求体，这就导致服务器无法解析你的请求，返回了500错误。

而SoapUI和curl能正常工作，是因为你在这些工具里直接构造了标准的JSON请求体，和API的预期格式完全匹配。

修正方案 #

你需要让RestTemplate把请求体序列化为JSON格式，有两种简单的实现方式：

方式1：使用Map快速构建请求体

直接用HashMap来组织请求参数，RestTemplate会自动把它序列化为JSON格式：

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);

Map<String, String> body = new HashMap<>();
body.put("api_key", "myApiKey");
body.put("platform", "Web");
body.put("user_id", "1");
body.put("type", "user");

HttpEntity<Map<String, String>> request = new HttpEntity<>(body, headers);
restTemplate.exchange("https://chatbase.com/api/message", HttpMethod.POST, request, Void.class);

方式2：创建POJO实体类（更规范易维护）

定义一个和Chatbase请求字段对应的实体类，这样代码可读性更高，后续扩展字段也更方便：

// 请求实体类
public class ChatbaseMessageRequest {
    private String api_key;
    private String platform;
    private String user_id;
    private String type;

    // 生成Getter和Setter方法，也可以用Lombok的@Data注解简化代码
    public String getApi_key() {
        return api_key;
    }

    public void setApi_key(String api_key) {
        this.api_key = api_key;
    }

    public String getPlatform() {
        return platform;
    }

    public void setPlatform(String platform) {
        this.platform = platform;
    }

    public String getUser_id() {
        return user_id;
    }

    public void setUser_id(String user_id) {
        this.user_id = user_id;
    }

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }
}

然后在请求中使用这个实体类：

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);

ChatbaseMessageRequest body = new ChatbaseMessageRequest();
body.setApi_key("myApiKey");
body.setPlatform("Web");
body.setUser_id("1");
body.setType("user");

HttpEntity<ChatbaseMessageRequest> request = new HttpEntity<>(body, headers);
restTemplate.exchange("https://chatbase.com/api/message", HttpMethod.POST, request, Void.class);

额外排查建议 #

如果调整后还是有问题，可以开启RestTemplate的DEBUG日志，查看实际发送的请求内容，确认请求体格式是否正确。在日志配置文件中添加：

logging.level.org.springframework.web.client.RestTemplate=DEBUG

这样就能看到请求头、请求体的详细信息，方便进一步定位问题。

内容的提问来源于stack exchange，提问作者Confused Dev