为何HttpURLConnection无法发送多个请求头？仅首个请求头生效

嘿，我来帮你捋捋这个问题——你用HttpURLConnection循环设置多个请求头，结果只有第一个成功发送，大概率是拆分头信息的逻辑出了问题，咱们一步步来解决：

最可能的元凶：split(":")的分割逻辑缺陷 #

你代码里用h.split(":")拆分键值对，但如果某个请求头的值里包含冒号（比如带冒号的Auth Token、或者复杂的Accept头），这个方法会把值也拆成好几段，要么触发IllegalArgumentException导致后续头都没机会设置，要么拆分出错误的键值对，导致头设置失败。

修复方案：用split(":", 2)做单次分割 #

改用split(":", 2)这个重载方法，它只会按第一个冒号拆分字符串，不管值里有多少冒号，都能保证拆分成正确的键和值两部分。另外记得去除键值前后的空白字符（比如冒号后的空格），避免无效的头信息：

URL url = new URL(fileOrUrl);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();

for (String h : getHeaders()) {
    // 仅按第一个冒号分割，避免值中的冒号破坏键值对结构
    String[] keyval = h.split(":", 2);
    if (keyval.length != 2) {
        throw new IllegalArgumentException("Invalid header format: " + h);
    }
    // 去除键和值前后的空白字符
    String headerKey = keyval[0].trim();
    String headerValue = keyval[1].trim();
    
    System.out.println("Setting header " + headerKey + ": " + headerValue);
    conn.addRequestProperty(headerKey, headerValue);
}

// 打印所有已设置的请求头，确认是否都添加成功
System.out.println("All configured request headers: " + conn.getRequestProperties());

其他需要排查的点 #

如果修复后还是有问题，可以检查这几个地方：

• 确认getHeaders()返回的列表是否正确：有没有格式错误的头、或者重复的字段名？
• 某些系统默认头可能被覆盖：比如User-Agent、Accept这类头，HttpURLConnection可能会自动设置默认值，如果想强制自定义，可以先调用setRequestProperty替换默认值，再添加其他头。
• 确认addRequestProperty的使用场景：这个方法是用来添加同键的多个值（比如多个Cookie），如果是替换已有头的值，应该用setRequestProperty，不过你的场景是添加不同的头，所以addRequestProperty是正确的选择。

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