PHP Laravel后端转HTTPS后Java客户端文件上传失败排查

问题背景 #

我把PHP Laravel后端切换为HTTPS后，Java客户端的文件上传功能直接失效了：证书处理看起来没问题，HTTPS POST请求也返回了200状态码，但文件就是没能存入数据库。

HTTP环境下能正常工作的代码：

Http post = new HttpPost(targetUrl);
MultipartEntityBuilder eb = MultipartEntityBuilder.create();
int counter = 0;
for (File file : files) {
 LogMe.debug(CloudCommunicator.class, ">>> " + file.getName());
 eb.addBinaryBody("" + counter, file);
 counter++;
}
post.setEntity(eb.build());
CloseableHttpResponse response = this.client.execute(post);
httpStatusCode = response.getStatusLine().getStatusCode();
HttpEntity responseEntity = response.getEntity();
String responseString = EntityUtils.toString(responseEntity, "UTF-8");
response.close();

切换到HTTPS后改用HttpsURLConnection的代码就不行了：

httpsConnection = (HttpsURLConnection) new URL(targetUrl).openConnection();
MultipartEntityBuilder eb = MultipartEntityBuilder.create();
int counter = 0;
for (File file : files) {
 LogMe.debug(CloudCommunicator.class, ">>> " + file.getName());
 eb.addBinaryBody("" + counter, file);
 counter++;
}
HttpEntity httpEntity = eb.build();
// String query = FsCommunicator.parseObjAsJson(requestData);
httpsConnection.setRequestProperty("Content-length", String.valueOf(httpEntity.getContentLength()));
httpsConnection.setRequestProperty("Content-Type", contentType.toString());
//httpsConnection.setRequestProperty("charset", "utf-8");
httpsConnection.setDoOutput(true);
httpsConnection.setDoInput(true);
httpsConnection.setRequestMethod("POST");
httpsConnection.setRequestProperty("Cookie", "token=" + msCookieManager.getCookieStore().getCookies().get(0).getValue());
//DataOutputStream output = new DataOutputStream(httpsConnection.getOutputStream());
httpEntity.writeTo(httpsConnection.getOutputStream());
while (httpEntity.isStreaming()) {
 Thread.sleep(100);
}
httpsConnection.getOutputStream().flush();
httpsConnection.getOutputStream().close();

用Postman测试HTTPS下的API完全正常，所以问题肯定出在Java客户端这边，求各位大佬给点解决思路！

问题分析 #

对比两段代码，核心差异是HTTP用了Apache HttpClient的HttpPost，HTTPS改成了原生HttpsURLConnection，问题大概率出在这两点：

• 原生HttpsURLConnection默认会严格校验服务器证书链，哪怕你觉得证书处理没问题，可能还是存在信任不完整的情况；
• 手动设置Content-length和Content-Type可能和实际传输的Multipart数据不匹配（比如MultipartEntityBuilder会自动生成带boundary的Content-Type，手动覆盖后后端解析失败）；
• 切换到原生连接后，没有复用之前HttpClient的Cookie管理和成熟的请求构造逻辑，容易踩细节坑。

解决方案 #

其实没必要切换到原生HttpsURLConnection，直接给Apache HttpClient配置SSL信任策略就行，这样能复用之前HTTP环境下的请求逻辑，避免构造请求的细节错误。以下是可行的配置代码：

try {
 KeyStore trustStore = KeyStore.getInstance(KeyStore.getDefaultType());
 trustStore.load(null); // 创建空密钥库
 InputStream fis = new FileInputStream(FsCommunicator.getResource("binary/xixLab.crt"));
 BufferedInputStream bis = new BufferedInputStream(fis);
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 while (bis.available() > 0) {
     java.security.cert.Certificate cert = cf.generateCertificate(bis);
     trustStore.setCertificateEntry("fiddler" + bis.available(), cert);
 }
 // 构建包含自定义信任证书的SSL上下文
 SSLContext sslcontext = SSLContexts.custom()
         .loadTrustMaterial(trustStore, new TrustSelfSignedStrategy())
         .build();
 // 生成支持自定义SSL的HttpClient实例
 client = HttpClients.custom()
         .setSslcontext(sslcontext)
         .setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE) // 仅测试环境用，生产环境禁用
         .setDefaultCookieStore(cookieStore)
         .build();
} catch (Exception e) {
    e.printStackTrace();
}

配置完成后，继续使用之前HTTP环境下的HttpPost上传逻辑就可以了，不需要改用HttpsURLConnection。

额外提醒 #

• 生产环境禁止使用NoopHostnameVerifier：这会跳过主机名校验，存在严重安全风险，正式环境请保留默认的主机名校验逻辑；
• 如果后端用的是CA签发的正规证书，不需要手动加载证书，只要Java环境的信任库包含对应CA根证书即可；
• 不要手动设置Content-Type：MultipartEntityBuilder会自动生成带正确boundary的Content-Type，手动覆盖会导致后端解析Multipart数据失败。

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