如何通过HTTP请求执行处理文件上传的Servlet？

看起来你遇到的问题很典型——浏览器里能正常触发的文件上传逻辑，用HttpClient调用却没反应，大概率是请求的目标路径不对，或者Multipart请求的构建有遗漏。我来帮你一步步排查和修复：

首先检查请求URL是否正确 #

你当前的HttpPost请求指向的是http://localhost:8080/Uploading.jsp，但JSP页面本身不是Servlet，你的文件上传逻辑应该是写在某个独立的Servlet里，这个Servlet有自己的映射路径（比如/upload或者/fileUpload）。浏览器里正常是因为Uploading.jsp的表单action属性指向了正确的Servlet路径，而你直接请求JSP页面自然不会触发Servlet的处理逻辑。

所以第一步，把HttpPost的URL改成你的Servlet的实际映射路径，比如：

HttpPost httppost = new HttpPost("http://localhost:8080/your-servlet-mapping-path");

你可以从web.xml的<url-pattern>标签，或者Servlet类上的@WebServlet注解里找到这个正确路径。

完整构建Multipart请求实体 #

你的代码里MultipartEntityBuilder.create()的部分没写完，这里需要确保正确设置文件字段名（要和Servlet里接收的参数名完全一致），以及完整构建请求实体。比如如果你的Servlet里用request.getPart("file")来接收文件，那字段名就要是"file"。

下面是完整的HttpClient调用示例代码：

CloseableHttpClient httpclient = HttpClients.createDefault();
try {
    // 替换成你的Servlet映射路径，不是JSP页面
    HttpPost httppost = new HttpPost("http://localhost:8080/uploadServlet");

    // 要上传的文件，指定内容类型
    FileBody fileBody = new FileBody(new File("D:\\test1.xlsx"), ContentType.DEFAULT_BINARY);
    // 可选：添加其他表单参数（如果Servlet需要的话）
    StringBody comment = new StringBody("这是一次测试上传", ContentType.TEXT_PLAIN);

    // 构建Multipart请求实体，注意文件的字段名要和Servlet接收的参数名匹配
    HttpEntity reqEntity = MultipartEntityBuilder.create()
            .addPart("file", fileBody) // 这里的"file"必须和Servlet里的参数名一致
            .addPart("comment", comment)
            .build();

    httppost.setEntity(reqEntity);

    System.out.println("执行请求: " + httppost.getRequestLine());
    CloseableHttpResponse response = httpclient.execute(httppost);
    try {
        System.out.println("----------------------------------------");
        System.out.println(response.getStatusLine());
        HttpEntity resEntity = response.getEntity();
        if (resEntity != null) {
            System.out.println("响应内容长度: " + resEntity.getContentLength());
            // 读取响应内容，方便排查问题
            String responseBody = EntityUtils.toString(resEntity, "UTF-8");
            System.out.println("响应内容: " + responseBody);
        }
        EntityUtils.consume(resEntity);
    } finally {
        response.close();
    }
} catch (IOException e) {
    e.printStackTrace();
} finally {
    try {
        httpclient.close();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

额外检查点 #

• 确保Servlet正确处理Multipart请求：如果是Servlet 3.0及以上版本，需要在Servlet类上添加@MultipartConfig注解；如果是旧版本，要在web.xml里配置<multipart-config>节点。
• 检查HttpClient依赖：如果是较旧的版本，MultipartEntityBuilder需要额外引入httpmime依赖，比如Maven配置：

  <dependency>
      <groupId>org.apache.httpcomponents</groupId>
      <artifactId>httpclient</artifactId>
      <version>4.5.14</version>
  </dependency>
  <dependency>
      <groupId>org.apache.httpcomponents</groupId>
      <artifactId>httpmime</artifactId>
      <version>4.5.14</version>
  </dependency>
  

• 模拟浏览器请求头：有些服务器的过滤器会校验请求头，你可以给HttpClient添加类似浏览器的请求头：

  httppost.addHeader("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");
  

按照上面的步骤调整后，应该就能正常触发Servlet的文件上传逻辑了。

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