用户传头像、传附件，是 Web 应用绕不开的功能。Servlet 3.0（现代 Jakarta EE）起提供了 Part 接口，不用再装第三方 commons-fileupload。注意：上传表单的 enctype 必须是 multipart/form-data，少一个字都收不到文件。

浏览器上传文件的表单有个"潜规则"：默认的表单编码只发普通键值对，文件这种二进制内容必须换 multipart/form-data 编码，它会把文件切成一块一块标好边界发过来。Servlet 3.0+ 的 Part 接口就是替你拆开这些边界。这也是为什么少写一个属性就收不到文件的根本原因。

上传 Servlet：接收文件并保存到磁盘

@WebServlet("/upload")
@MultipartConfig(maxFileSize = 10 * 1024 * 1024,   // 单文件最大 10MB
                 maxRequestSize = 50 * 1024 * 1024)
public class UploadServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException, ServletException {
        Part filePart = req.getPart("avatar");     // 对应表单里 input name="avatar"
        String submittedName = filePart.getSubmittedFileName();

        // 用 UUID 重命名，防止两个用户都叫 a.jpg 互相覆盖
        String ext = submittedName.substring(submittedName.lastIndexOf("."));
        String savedName = java.util.UUID.randomUUID() + ext;

        filePart.write("/data/uploads/" + savedName);   // 落盘
        resp.getWriter().write("上传成功：" + savedName);
    }
}

对应的上传表单（HTML 页面里）

<form action="upload" method="post" enctype="multipart/form-data">
  <input type="file" name="avatar" accept="image/*">
  <button type="submit">上传</button>
</form>

文件下载：把服务器上的文件发给浏览器

@WebServlet("/download")
public class DownloadServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        String fileName = req.getParameter("name");
        Path file = Path.of("/data/uploads/", fileName);

        // 关键：告诉浏览器"这是要下载的附件"，并给出建议保存的文件名
        resp.setContentType("application/octet-stream");
        resp.setHeader("Content-Disposition",
            "attachment;filename=" + URLEncoder.encode(fileName, StandardCharsets.UTF_8));

        // try-with-resources 把文件复制到响应输出流
        try (OutputStream out = resp.getOutputStream()) {
            Files.copy(file, out);
        }
    }
}