Tomcat上传文件大小限制的默认规则
Tomcat作为常用的Java Web服务器，默认对通过Servlet 3.0及以上规范实现的文件上传做了大小限制，默认最大上传大小为2MB，单个请求总大小默认限制为2MB。如果上传的文件超过这个默认值，就会返回400错误或者抛出文件大小超限的异常。这个限制不是由应用代码控制的，而是Tomcat内置的请求解析规则决定的，因此需要在Tomcat的配置文件中做对应调整。
Tomcat不同版本的配置方式
Tomcat 7及以上版本（Servlet 3.0+）
Tomcat 7及之后的版本支持Servlet 3.0规范，文件上传的大小限制可以通过修改web.xml配置文件来实现，也可以在Servlet代码中通过注解配置，这里主要介绍XML配置的方式，适合全局统一管理。
在Web应用的WEB-INF/web.xml中添加如下配置：
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<!-- 配置文件上传大小限制 -->
<multipart-config>
<!-- 单个文件最大大小，单位字节，这里设置为10MB -->
<max-file-size>10485760</max-file-size>
<!-- 整个请求的最大大小，单位字节，这里设置为20MB -->
<max-request-size>20971520</max-request-size>
<!-- 文件存储到磁盘的阈值，单位字节 -->
<file-size-threshold>0</file-size-threshold>
</multipart-config>
</web-app>
上面的配置中，max-file-size用来限制单个上传文件的大小，max-request-size用来限制整个请求的总大小，如果一次上传多个文件，总大小不能超过这个值。
Tomcat 6及以下版本
Tomcat 6不支持Servlet 3.0规范，没有内置的multipart-config配置项，需要通过第三方组件比如Apache Commons FileUpload来实现文件上传，此时的大小限制需要在应用代码中配置，或者在处理上传的Servlet对应的配置中设置。如果是使用Commons FileUpload，核心配置代码如下：
// 创建磁盘文件工厂 DiskFileItemFactory factory = new DiskFileItemFactory(); // 设置缓冲区大小，单位字节 factory.setSizeThreshold(1024); // 创建文件上传处理器 ServletFileUpload upload = new ServletFileUpload(factory); // 设置单个文件最大大小，单位字节，这里设置为10MB upload.setFileSizeMax(10485760); // 设置整个请求最大大小，单位字节，这里设置为20MB upload.setSizeMax(20971520);
Tomcat全局配置方式
如果希望所有部署在Tomcat下的应用都生效上传大小限制，可以修改Tomcat的全局配置文件conf/web.xml，找到默认的Servlet配置，添加multipart-config配置，示例如下：
<servlet>
<servlet-name>default</servlet-name>
<servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>0</param-value>
</init-param>
<init-param>
<param-name>listings</param-name>
<param-value>false</param-value>
</init-param>
<multipart-config>
<max-file-size>10485760</max-file-size>
<max-request-size>20971520</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
<load-on-startup>1</load-on-startup>
</servlet>
配置注意事项
- 配置的大小单位是字节，1MB等于1048576字节，计算时需要注意换算，避免设置错误。
- 如果同时配置了全局的Tomcat web.xml和应用自己的web.xml，应用级别的配置会覆盖全局配置。
- 修改配置后需要重启Tomcat才能生效，否则配置不会生效。
- 如果上传的文件还是被限制，需要检查是否有Nginx、Apache等反向代理服务器也做了上传大小限制，比如Nginx的
client_max_body_size参数也需要对应调整。
常见问题排查
如果配置完成后上传仍然提示大小超限，可以按照以下步骤排查：
- 检查配置的单位是否正确，是否误将MB当成字节填写。
- 确认修改的是对应应用的web.xml，而不是其他应用的配置文件。
- 查看Tomcat的启动日志，确认配置是否被正确加载，有没有语法错误。
- 检查应用中是否有其他代码层面的文件大小限制，比如拦截器或者自定义的上传工具类中的限制。