如何在Tomcat中为指定URL单独设置最大POST请求大小限制

假设你已经在Tomcat全局Connector中设置了maxPostSize="20971520"（对应20MB），要给/api/data/accept这个URL单独设置1MB的POST大小限制，可以通过Tomcat的MaxPostSizeValve来实现，具体配置方式如下：

1. 全局Connector基础配置（已完成） #

确保你的conf/server.xml中的Connector已经设置全局maxPostSize：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           maxPostSize="20971520" /> <!-- 20MB，单位为字节 -->

2. 针对特定URL添加Valve配置 #

方式一：仅对当前Web应用生效 #

在你的应用的META-INF/context.xml文件中添加以下配置（如果没有该文件则新建）：

<Context>
    <!-- 其他已有配置 -->
    <Valve className="org.apache.catalina.valves.MaxPostSizeValve"
           maxPostSize="1048576" <!-- 1MB，单位为字节 -->
           addDefaultCharset="true"
           pattern="^/api/data/accept$" /> <!-- 精确匹配目标URL -->
</Context>

方式二：全局Host级别配置（对指定应用生效） #

在Tomcat的conf/Catalina/localhost/[你的应用上下文名].xml中添加配置（无文件则新建），或者直接在conf/server.xml的<Host>标签内嵌套：

<Host name="localhost" appBase="webapps"
      unpackWARs="true" autoDeploy="true">
    <!-- 其他已有配置 -->
    <Context path="/你的应用上下文路径">
        <Valve className="org.apache.catalina.valves.MaxPostSizeValve"
               maxPostSize="1048576"
               addDefaultCharset="true"
               pattern="^/api/data/accept$" />
    </Context>
</Host>

关键注意点 #

• 单位为字节：1MB = 10241024 = 1048576，20MB = 201024*1024 = 20971520。
• 正则匹配：pattern属性支持正则表达式，^/api/data/accept$是精确匹配；若要匹配该路径下的所有子请求，可改为^/api/data/accept.*$。
• 版本差异：Tomcat 8.5及以上版本中，maxPostSize设为-1表示不限制POST大小，0表示拒绝所有POST请求（旧版本中0代表不限制，注意区分）。
• 优先级：MaxPostSizeValve的配置会覆盖全局Connector的maxPostSize，仅当请求路径匹配pattern时生效，其他请求仍使用全局20MB限制。

内容的提问来源于stack exchange，提问作者J.Kuai