1. 从400 Bad Request看RestTemplate的常见坑点
第一次遇到HttpClientErrorException: 400时,我盯着控制台的红字一脸懵——明明代码能编译通过,为什么服务器就是不认我的请求?后来才发现,这就像给朋友发微信,如果打错字或者漏说关键信息,对方也会回个"?"。400错误就是服务器在向我们表达这种困惑。
RestTemplate作为Spring生态中的HTTP客户端老将,用起来简单但坑也不少。最常见的问题集中在三个维度:
-
请求体格式:比如把JSON字符串的引号写成中文标点,或者日期格式不符合API要求。有次我遇到个隐蔽问题:用FastJson序列化的对象包含
isActive字段,但服务端用的是Jackson,结果因为字段名序列化差异导致400错误。 -
URL构造:手动拼接URL时容易漏编码特殊字符。比如参数值包含
&符号时,如果不做URL编码就会破坏整个查询字符串结构。更稳妥的做法是用UriComponentsBuilder:
java复制String url = UriComponentsBuilder.fromHttpUrl("http://api.example.com/search")
.queryParam("q", "Java&Spring") // 自动编码特殊字符
.build()
.toUriString();
- 请求头设置:特别是Content-Type和认证头。曾经有个第三方API文档写着接受
application/json,实际测试发现必须用application/json;charset=UTF-8才不会报400。这类问题只能通过抓包对比成功和失败的请求才能发现。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 防御式编程四重奏:构建健壮的API客户端
2.1 请求预校验机制
在请求发出前做校验就像出门前检查"手机、钱包、钥匙",能避免很多低级错误。我习惯为不同API定义校验规则:
java复制public void validateRequest(MyRequestDto dto) {
Objects.requireNonNull(dto.getUserId(), "用户ID不能为空");
