Java通过HTTP POST获取Reddit API令牌返回5xx错误问题排查

• 核心问题是Apache HttpClient的默认凭证认证机制为挑战响应模式：通过setDefaultCredentialsProvider配置的Basic认证信息，不会在首次请求时携带。只有当服务端返回401状态码、且响应头携带WWW-Authenticate: Basic标识要求认证时，HttpClient才会在重试请求中自动追加Authorization认证头。但Reddit的access_token接口不会返回401认证挑战，未携带有效Basic凭证的请求会被直接返回500错误，根本无法触发HttpClient的自动认证逻辑。
• 可正常运行的Python版本中，requests.auth.HTTPBasicAuth会在首次发起请求时直接构造并携带Authorization: Basic <base64(CLIENT_ID:API_SECRET)>请求头，完全匹配Reddit接口的认证要求，因此可以正常返回结果。
• 原代码手动编码拼接表单参数的写法不是导致500错误的核心原因，但存在编码异常风险，不属于官方推荐的表单提交写法。

按照以下两点调整代码即可正常获取令牌：

1. 移除原代码中通过CredentialsProvider配置凭证的逻辑，手动构造Basic认证请求头，在首次发请求时就携带Authorization头
2. 使用HttpClient自带的UrlEncodedFormEntity构造表单请求实体，替代手动编码拼接StringEntity的逻辑，规避编码问题

修复后的可运行代码如下：

import org.apache.http.HttpEntity;
import org.apache.http.NameValuePair;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Base64;
import java.util.List;

public class RedditTokenFetcher {
    public static void main(String[] args) throws Exception {
        HttpPost accessTokenRequest = new HttpPost("https://www.reddit.com/api/v1/access_token");

        // 主动添加Basic认证头，首次请求即携带客户端凭证
        String clientId = "替换为你的CLIENT ID";
        String clientSecret = "替换为你的API SECRET KEY";
        String rawAuth = clientId + ":" + clientSecret;
        String encodedAuth = Base64.getEncoder().encodeToString(rawAuth.getBytes(StandardCharsets.UTF_8));
        accessTokenRequest.addHeader("Authorization", "Basic " + encodedAuth);
        accessTokenRequest.addHeader("User-Agent", "MyBot/0.0.1");

        // 构造表单参数
        List<NameValuePair> formParams = new ArrayList<>(3);
        formParams.add(new BasicNameValuePair("grant_type", "password"));
        formParams.add(new BasicNameValuePair("username", "替换为你的Reddit用户名"));
        formParams.add(new BasicNameValuePair("password", "替换为你的Reddit密码"));
        accessTokenRequest.setEntity(new UrlEncodedFormEntity(formParams, StandardCharsets.UTF_8));

        // 发起请求
        try (CloseableHttpClient httpClient = HttpClientBuilder.create().build();
             CloseableHttpResponse response = httpClient.execute(accessTokenRequest)) {
            HttpEntity responseEntity = response.getEntity();
            if (responseEntity != null) {
                String result = EntityUtils.toString(responseEntity, StandardCharsets.UTF_8);
                System.out.println(result);
            }
        }
    }
}

补充说明：如果你的Reddit账号开启了两步验证，使用password模式授权时需要传入两步验证生成的设备专用密码，而非账号原登录密码，否则会返回认证失败错误。

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