Android中HttpURLConnection POST数据报404，Postman正常求排查

Hey there, sorry to hear you’re stuck with this 404 issue—especially since the same URL works perfectly in Postman! This is almost always caused by tiny, easy-to-miss differences between your Java code’s request and what Postman sends under the hood. Let’s break down the most likely fixes:

1. Double-Check Your URL (The #1 Culprit) #

More often than not, the URL in your Java code isn’t exactly the same as the one in Postman. Common pitfalls:

• Missing a trailing slash: Postman often automatically handles this, but Java HTTP clients might not. For example, https://api.example.com/register vs https://api.example.com/register/ could point to different endpoints.
• Typos or environment mismatches: Did you hardcode a staging URL in Java but test production in Postman? Or misspell a path segment (like /user instead of /users)?
• Query parameter errors: If your URL has params, make sure they’re correctly formatted (no missing & or = signs).

Quick fix: Print the full URL your Java code is using before sending the request, then copy-paste it directly into Postman to test:

// If using HttpURLConnection
URL url = new URL("your-url-here");
System.out.println("Full Request URL: " + url.toString());

// If using OkHttp
HttpUrl httpUrl = HttpUrl.parse("your-url-here");
System.out.println("Full Request URL: " + httpUrl);

2. Match Postman’s Request Headers Exactly #

Postman adds default headers (like Content-Type) or might include auth tokens, API keys, or other custom headers that your Java code is missing. Servers often use these headers to route requests correctly—without them, you’ll get a 404 even if the URL is right.

How to check:

1. Open your working Postman request.
2. Click the Code tab (right sidebar).
3. Select Java (choose the same HTTP client you’re using: OkHttp, HttpURLConnection, etc.).
4. Compare the generated code’s headers with your own. For example, if you’re sending JSON, you must include:

   // For HttpURLConnection
   conn.setRequestProperty("Content-Type", "application/json");
   // For OkHttp
   Request request = new Request.Builder()
       .url(url)
       .addHeader("Content-Type", "application/json")
       .post(requestBody)
       .build();
   

3. Fix URL Encoding Issues #

If your URL or request body contains special characters (spaces, &, =, accented letters), Postman automatically encodes them, but Java might not. This can corrupt the URL, leading the server to reject it as invalid (returning 404).

Fixes:

• Use URLEncoder.encode() for query parameters or path segments:

  String encodedUsername = URLEncoder.encode("John Doe", StandardCharsets.UTF_8);
  URL url = new URL("https://api.example.com/users/" + encodedUsername);
  

• Use the URI class to build valid URLs instead of concatenating strings:

  URI uri = new URI("https://api.example.com", "/users/John Doe", null);
  URL url = uri.toURL(); // Automatically encodes the path
  

4. Check Proxy/Network Configuration #

If your Java app runs behind a corporate proxy (but Postman is configured to use it), your request might be hitting the proxy instead of the actual server—resulting in a proxy-generated 404.

Check:

• Verify if Postman uses a proxy (Settings > Proxy) and mirror that configuration in Java. You can set system properties:

  System.setProperty("http.proxyHost", "your-proxy-host");
  System.setProperty("http.proxyPort", "your-proxy-port");
  // For HTTPS
  System.setProperty("https.proxyHost", "your-proxy-host");
  System.setProperty("https.proxyPort", "your-proxy-port");
  

5. Inspect the Full Request with Debugging Tools #

If none of the above works, capture the full request your Java code sends and compare it side-by-side with Postman’s request. Tools like:

• Wireshark: Capture network traffic to see the exact HTTP request.
• OkHttp Interceptor: Log every detail of your request (method, URL, headers, body):

  OkHttpClient client = new OkHttpClient.Builder()
      .addInterceptor(chain -> {
          Request req = chain.request();
          System.out.println("=== Request Details ===");
          System.out.println("Method: " + req.method());
          System.out.println("URL: " + req.url());
          System.out.println("Headers: " + req.headers());
          // Log body if needed
          if (req.body() != null) {
              Buffer buffer = new Buffer();
              req.body().writeTo(buffer);
              System.out.println("Body: " + buffer.readUtf8());
          }
          return chain.proceed(req);
      })
      .build();
  

Start with the URL and header checks—those resolve 90% of these cases. Let me know if you find a mismatch, and we can dive deeper!

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