Java 11下HttpPost请求返回HTTP 500错误排查求助

Let's break down the potential issues in your code that might be causing the 500 error when moving from Java 7 to Java 11, along with actionable fixes:

First, here's your original code formatted for clarity:

private HttpPost getRequest() { 
    HttpPost httpRequest = null; 
    postParameter(); 
    String queryString = ""; 
    Set<Entry<String, String>> getPairs = this.parameterMap.entrySet(); 
    for (Entry<String, String> entry : getPairs) { 
        try { 
            queryString += URLEncoder.encode(entry.getKey(), this.CHARSET) + "=" + URLEncoder.encode(entry.getValue(), this.CHARSET) + "&"; 
        } catch (UnsupportedEncodingException e) { } 
    } 
    if (!queryString.isEmpty()) { 
        queryString = "?" + queryString; 
    } 
    httpRequest = new HttpPost("http://mydomainname.com/java_test.php"); 
    String user_password = username+":"+password; 
    byte[] Author = Base64.getEncoder().encode(user_password.getBytes()); 
    String Authorization = null; 
    try { 
        Authorization = new String(Author, "UTF-8"); 
    } catch (UnsupportedEncodingException e1) { } 
    String partnerID ="XXXXXX"; 
    httpRequest.setHeader("Authorization",Authorization); 
    httpRequest.setHeader("PartnerId",partnerID); 
    httpRequest.addHeader(HttpHeaders.CONTENT_TYPE,"application/json"); 
    httpRequest.addHeader(HttpHeaders.ACCEPT,"application/json"); 
    List<BasicNameValuePair> nameValuePairs = new ArrayList<BasicNameValuePair>(); 
    Set<Entry<String, String>> postPairs = this.postParametersMap.entrySet(); 
    for(Entry<String, String> entry : postPairs) { 
        BasicNameValuePair pair = new BasicNameValuePair(entry.getKey(), entry.getValue()); 
        nameValuePairs.add(pair); 
    } 
    UrlEncodedFormEntity parameters = null; 
    try { 
        parameters = new UrlEncodedFormEntity(nameValuePairs, this.CHARSET); 
    } catch (UnsupportedEncodingException e) { } 
    httpRequest.setEntity(parameters); 
    return httpRequest; 
}

1. Missing "Basic" Prefix in Authorization Header #

Your code correctly encodes the username:password string with Base64, but omits the required Basic prefix for HTTP Basic Authentication. The header must follow this format:

Authorization: Basic <base64-encoded-username-password>

It’s likely your Java 7 environment worked because the server had lenient parsing, but Java 11 (or updated server logic) now enforces the standard format, leading to authentication failure and a 500 error.

Fix:

Authorization = "Basic " + new String(Author, "UTF-8");

2. Conflicting Content-Type Header #

You manually set the Content-Type header to application/json, but then use UrlEncodedFormEntity—which automatically sets the content type to application/x-www-form-urlencoded. This mismatch confuses the server, which expects JSON but receives form-encoded data, triggering a parsing error.

Fix:
If you intend to send form data, remove the JSON content-type header:

// Remove this line:
// httpRequest.addHeader(HttpHeaders.CONTENT_TYPE,"application/json");

If you actually need to send JSON, replace the UrlEncodedFormEntity with a StringEntity containing a JSON payload instead of form parameters.

3. Silent Exception Handling #

Your code catches UnsupportedEncodingException but does nothing with it. If this.CHARSET is invalid or unsupported in Java 11, your query string or request entity will be incomplete or empty, leading the server to return a 500 error.

Fix:
Add logging or rethrow the exception to catch encoding issues early:

catch (UnsupportedEncodingException e) {
    throw new RuntimeException("Failed to encode request parameters", e);
    // Or use a logger: LOGGER.error("Parameter encoding failed", e);
}

4. Query String Handling for POST Requests #

You’re appending parameters from parameterMap to the URL’s query string, but POST requests typically send parameters in the request body. While some servers accept query parameters in POST requests, this could cause issues if the server expects all parameters in the body (especially if Java 11’s HttpClient handles URL encoding differently than Java 7).

Fix:
If these parameters are meant to be POST data, move them into postParametersMap instead of appending them to the URL. If they truly need to be query parameters, confirm the server is configured to accept them alongside form data.

After applying these fixes, test your request again. The missing "Basic" prefix and conflicting Content-Type header are the most likely culprits for the 500 error.

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