Java Spring调用外部OAuth2接口遇401 Unauthorized问题求助

核心问题分析 #

• 参数名不符合规范：OAuth2协议中，授权类型的参数名是全小写的grant_type，你代码里写的Grant_type大小写错误，外部API无法识别该参数，这是导致401错误的主要原因。
• 请求内容类型缺失：调用OAuth2的token接口时，要求请求体以application/x-www-form-urlencoded格式发送，你的代码未设置该请求头，可能导致API无法解析参数。
• Base64编码字符集隐患：auth.getBytes()使用系统默认字符集，不同环境下可能出现编码不一致，建议显式指定UTF-8避免乱码。
• RestTemplate请求封装错误：你直接将headers作为postForEntity的第四个参数是错误的，正确做法是将请求体和请求头封装为HttpEntity对象传入。

修正后的代码 #

import java.nio.charset.StandardCharsets;
import org.springframework.http.MediaType;
import org.springframework.http.HttpEntity;

public String getAuth(String client_id, String app_secret) {
    String auth = client_id + ":" + app_secret;
    // 显式指定UTF-8字符集编码
    return Base64.getEncoder().encodeToString(auth.getBytes(StandardCharsets.UTF_8));
}

@GetMapping(value = "/token")
public Object generateAccessToken() {
    String auth = this.getAuth(
        "CLIENT_ID",
        "APP_SECRET"
    );

    RestTemplate restTemplate = new RestTemplate();

    String base = "https://external-api.com";
    HttpHeaders headers = new HttpHeaders();
    headers.set("Authorization", "Basic " + auth);
    // 设置符合要求的请求内容类型
    headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

    MultiValueMap<String, String> requestParams = new LinkedMultiValueMap<>();
    // 修正为规范的参数名
    requestParams.add("grant_type", "client_credentials");

    // 正确封装请求体和请求头为HttpEntity
    HttpEntity<MultiValueMap<String, String>> requestEntity = new HttpEntity<>(requestParams, headers);
    
    ResponseEntity<Object> response = restTemplate.postForEntity(
        base + "/v1/oauth2/token",
        requestEntity,
        Object.class
    );

    return response.getBody();
}

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