调用viglink API的PHP带Authorization头代码转Java后返回null问题求助

核心问题点 #

Java的HttpURLConnection默认配置和PHP的cURL默认配置存在差异，导致请求不符合VigLink API的要求，常见的几个问题如下：

• PHP的cURL会自动携带合法的User-Agent请求头，而HttpURLConnection默认要么不带该头，要么携带的头内容被API拦截
• 未判断HTTP响应状态码就直接读取输入流，如果返回4xx/5xx错误，getInputStream()会直接返回空或者抛出异常，你直接抛出上层异常没捕获所以看不到具体报错
• 没有显式指定请求方法、超时等必要配置，部分环境下会出现请求无响应的情况

修复步骤 #

1. 补充必要的请求头与配置，显式指定请求方法、超时时间，补充User-Agent、Accept等通用请求头
2. 先检查响应状态码，再读取对应数据流：状态码为2xx时读取正常输入流，其他状态读取错误流查看具体报错信息

修复后的代码示例 #

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class VigLinkApiTest {
    public static void main(String[] args) {
        HttpURLConnection conn = null;
        BufferedReader reader = null;
        try {
            URL url = new URL("https://rest.viglink.com/api/product/search?apiKey=abc&country=de&itemsPerPage=100");
            conn = (HttpURLConnection) url.openConnection();
            // 显式指定GET请求
            conn.setRequestMethod("GET");
            // 设置超时时间，单位毫秒
            conn.setConnectTimeout(5000);
            conn.setReadTimeout(10000);
            // 允许自动重定向
            conn.setInstanceFollowRedirects(true);
            // 补充请求头，和cURL的请求头对齐
            conn.setRequestProperty("Authorization", "secret xyz");
            conn.setRequestProperty("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36");
            conn.setRequestProperty("Accept", "*/*");
            
            // 获取响应状态码
            int responseCode = conn.getResponseCode();
            System.out.println("响应状态码：" + responseCode);
            
            // 根据状态码选择读取的流
            if (responseCode >= 200 && responseCode < 300) {
                reader = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
            } else {
                reader = new BufferedReader(new InputStreamReader(conn.getErrorStream(), "UTF-8"));
            }
            
            // 读取响应内容
            StringBuilder response = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            System.out.println("响应内容：" + response.toString());
            
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 关闭流和连接
            try {
                if (reader != null) reader.close();
                if (conn != null) conn.disconnect();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

验证步骤 #

运行修复后的代码首先查看打印的响应状态码：

• 如果状态码是401，检查apiKey和Authorization头的内容是否正确
• 如果状态码是4xx其他值，根据错误流返回的提示调整请求参数
• 如果状态码是200但内容为空，检查请求参数是否和PHP版本完全对齐

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