版本：4.0.2

本站内所有文档均为中英对照文档，点击中文可以显示英文。此提醒连续关闭5次后，将不再显示。

文档内容来源于 spring.io，由 springdoc.tech 翻译，版权归属于 SPRING.IO (Broadcom. Inc)。可供个人学习、研究，未经许可，不得进行转载或用于商业行为。

映射（`mappings`）

QWen Max 中英对照 Mappings (mappings) Mappings (mappings)

mappings 端点提供有关应用程序请求映射的信息。

获取映射

要获取映射信息，请向 /actuator/mappings 发起 GET 请求，如下列基于 curl 的示例所示：

$ curl 'http://localhost:36453/actuator/mappings' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.3.2' \
    -H 'accept: */*'

得到的响应类似于以下内容：

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Transfer-Encoding: chunked
Date: Thu, 22 Jan 2026 12:44:00 GMT
Content-Length: 5780

{
  "contexts" : {
    "application" : {
      "mappings" : {
        "dispatcherServlets" : {
          "dispatcherServlet" : [ {
            "details" : {
              "handlerMethod" : {
                "className" : "org.springframework.boot.webmvc.actuate.endpoint.web.WebMvcEndpointHandlerMapping.WebMvcLinksHandler",
                "descriptor" : "(Ljakarta/servlet/http/HttpServletRequest;Ljakarta/servlet/http/HttpServletResponse;)Ljava/util/Map;",
                "name" : "links"
              },
              "requestMappingConditions" : {
                "consumes" : [ ],
                "headers" : [ ],
                "methods" : [ "GET" ],
                "params" : [ ],
                "patterns" : [ "/actuator" ],
                "produces" : [ {
                  "mediaType" : "application/vnd.spring-boot.actuator.v3+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/vnd.spring-boot.actuator.v2+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/json",
                  "negated" : false
                } ]
              }
            },
            "handler" : "Actuator root web endpoint",
            "predicate" : "{GET [/actuator], produces [application/vnd.spring-boot.actuator.v3+json || application/vnd.spring-boot.actuator.v2+json || application/json]}"
          }, {
            "details" : {
              "handlerMethod" : {
                "className" : "org.springframework.boot.webmvc.actuate.endpoint.web.AbstractWebMvcEndpointHandlerMapping.OperationHandler",
                "descriptor" : "(Ljakarta/servlet/http/HttpServletRequest;Ljava/util/Map;)Ljava/lang/Object;",
                "name" : "handle"
              },
              "requestMappingConditions" : {
                "consumes" : [ ],
                "headers" : [ ],
                "methods" : [ "GET" ],
                "params" : [ ],
                "patterns" : [ "/actuator/mappings" ],
                "produces" : [ {
                  "mediaType" : "application/vnd.spring-boot.actuator.v3+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/vnd.spring-boot.actuator.v2+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/json",
                  "negated" : false
                } ]
              }
            },
            "handler" : "Actuator web endpoint 'mappings'",
            "predicate" : "{GET [/actuator/mappings], produces [application/vnd.spring-boot.actuator.v3+json || application/vnd.spring-boot.actuator.v2+json || application/json]}"
          }, {
            "details" : {
              "handlerFunction" : {
                "className" : "org.springframework.boot.actuate.docs.web.mappings.MappingsEndpointServletDocumentationTests$TestConfiguration$$Lambda/0x000000004ed251b0"
              }
            },
            "handler" : "org.springframework.boot.actuate.docs.web.mappings.MappingsEndpointServletDocumentationTests$TestConfiguration$$Lambda/0x000000004ed251b0@54950502",
            "predicate" : "(GET && /foo)"
          }, {
            "details" : {
              "handlerMethod" : {
                "className" : "org.springframework.boot.actuate.docs.web.mappings.MappingsEndpointServletDocumentationTests.ExampleController",
                "descriptor" : "()Ljava/lang/String;",
                "name" : "example"
              },
              "requestMappingConditions" : {
                "consumes" : [ {
                  "mediaType" : "application/json",
                  "negated" : false
                }, {
                  "mediaType" : "application/xml",
                  "negated" : true
                } ],
                "headers" : [ {
                  "name" : "X-Custom",
                  "negated" : false,
                  "value" : "Foo"
                } ],
                "methods" : [ "POST" ],
                "params" : [ {
                  "name" : "a",
                  "negated" : true,
                  "value" : "alpha"
                } ],
                "patterns" : [ "/" ],
                "produces" : [ {
                  "mediaType" : "text/plain",
                  "negated" : false
                } ]
              }
            },
            "handler" : "org.springframework.boot.actuate.docs.web.mappings.MappingsEndpointServletDocumentationTests$ExampleController#example()",
            "predicate" : "{POST [/], params [a!=alpha], headers [X-Custom=Foo], consumes [application/json || !application/xml], produces [text/plain]}"
          }, {
            "handler" : "ResourceHttpRequestHandler [classpath [META-INF/resources/webjars/]]",
            "predicate" : "/webjars/**"
          }, {
            "handler" : "ResourceHttpRequestHandler [classpath [META-INF/resources/], classpath [resources/], classpath [static/], classpath [public/], ServletContext [/]]",
            "predicate" : "/**"
          } ]
        },
        "servletFilters" : [ {
          "className" : "org.springframework.boot.servlet.filter.OrderedRequestContextFilter",
          "name" : "requestContextFilter",
          "servletNameMappings" : [ ],
          "urlPatternMappings" : [ "/*" ]
        }, {
          "className" : "org.springframework.boot.servlet.filter.OrderedFormContentFilter",
          "name" : "formContentFilter",
          "servletNameMappings" : [ ],
          "urlPatternMappings" : [ "/*" ]
        } ],
        "servlets" : [ {
          "className" : "org.springframework.web.servlet.DispatcherServlet",
          "mappings" : [ "/" ],
          "name" : "dispatcherServlet"
        } ]
      }
    }
  }
}

响应结构

响应包含应用程序映射的详细信息。响应中找到的项目取决于 Web 应用程序的类型（响应式或基于 Servlet）。下表描述了响应中常见元素的结构：

路径	类型	描述
`contexts`	`Object`	以 id 为键的应用程序上下文。
`contexts.*.mappings`	`Object`	上下文中的映射，以映射类型为键。
`contexts.*.mappings.dispatcherServlets`	`Object`	Dispatcher servlet 映射（如果存在）。
`contexts.*.mappings.servletFilters`	`Array`	Servlet 过滤器映射（如果存在）。
`contexts.*.mappings.servlets`	`Array`	Servlet 映射（如果存在）。
`contexts.*.mappings.dispatcherHandlers`	`Object`	Dispatcher handler 映射（如果存在）。
`contexts.*.parentId`	`String`	父应用程序上下文的 id（如果存在）。

可在 contexts.*.mappings 中找到的条目将在以下各节中描述。

Dispatcher Servlets 响应结构

当使用 Spring MVC 时，响应中包含 contexts.*.mappings.dispatcherServlets 下任何 DispatcherServlet 请求映射的详细信息。下表描述了响应中此部分的结构：

路径	类型	描述
`*`	`Array`	Dispatcher servlet 映射（如果有的话），以 dispatcher servlet bean 名称为键。
`*.[].details`	`Object`	关于映射的额外实现特定细节。可选。
`*.[].handler`	`String`	映射的处理器。
`*.[].predicate`	`String`	映射的谓词。
`*.[].details.handlerFunction`	`Object`	处理此映射请求的函数的详细信息（如果有的话）。
`*.[].details.handlerFunction.className`	`String`	函数所属类的全限定名。
`*.[].details.handlerMethod`	`Object`	处理此映射请求的方法的详细信息（如果有的话）。
`*.[].details.handlerMethod.className`	`Varies`	方法所属类的全限定名。
`*.[].details.handlerMethod.name`	`Varies`	方法名称。
`*.[].details.handlerMethod.descriptor`	`Varies`	方法的描述符，按 Java 语言规范定义。
`*.[].details.requestMappingConditions`	`Object`	请求映射条件的详细信息。
`*.[].details.requestMappingConditions.consumes`	`Varies`	consumes 条件的详细信息。
`*.[].details.requestMappingConditions.consumes.[].mediaType`	`Varies`	消费的媒体类型。
`*.[].details.requestMappingConditions.consumes.[].negated`	`Varies`	媒体类型是否被否定。
`*.[].details.requestMappingConditions.headers`	`Varies`	headers 条件的详细信息。
`*.[].details.requestMappingConditions.headers.[].name`	`Varies`	header 的名称。
`*.[].details.requestMappingConditions.headers.[].value`	`Varies`	header 所需的值（如果有的话）。
`*.[].details.requestMappingConditions.headers.[].negated`	`Varies`	值是否被否定。
`*.[].details.requestMappingConditions.methods`	`Varies`	处理的 HTTP 方法。
`*.[].details.requestMappingConditions.params`	`Varies`	params 条件的详细信息。
`*.[].details.requestMappingConditions.params.[].name`	`Varies`	参数名称。
`*.[].details.requestMappingConditions.params.[].value`	`Varies`	参数所需的值（如果有的话）。
`*.[].details.requestMappingConditions.params.[].negated`	`Varies`	值是否被否定。
`*.[].details.requestMappingConditions.patterns`	`Varies`	标识由该映射处理的路径的模式。
`*.[].details.requestMappingConditions.produces`	`Varies`	produces 条件的详细信息。
`*.[].details.requestMappingConditions.produces.[].mediaType`	`Varies`	生成的媒体类型。
`*.[].details.requestMappingConditions.produces.[].negated`	`Varies`	媒体类型是否被否定。

Servlets 响应结构

当使用 Servlet 栈时，响应中包含 contexts.*.mappings.servlets 下任何 Servlet 映射的详细信息。下表描述了响应中该部分的结构：

Path	Type	Description
`[].mappings`	`Array`	Servlet 的映射。
`[].name`	`String`	Servlet 的名称。
`[].className`	`String`	Servlet 的类名。

Servlet 过滤器响应结构

当使用 Servlet 栈时，响应中包含 contexts.*.mappings.servletFilters 下任何 Filter 映射的详细信息。下表描述了响应中此部分的结构：

Path	Type	Description
`[].servletNameMappings`	`Array`	过滤器映射的 Servlet 名称。
`[].urlPatternMappings`	`Array`	过滤器映射的 URL 模式。
`[].name`	`String`	过滤器的名称。
`[].className`	`String`	过滤器的类名。

Dispatcher Handlers 响应结构

当使用 Spring WebFlux 时，响应中包含 contexts.*.mappings.dispatcherHandlers 下所有 DispatcherHandler 请求映射的详细信息。下表描述了该部分响应的结构：

路径	类型	描述
`*`	`Array`	Dispatcher handler 映射（如果有），以 dispatcher handler bean 名称为键。
`*.[].details`	`Object`	关于映射的额外实现特定细节。可选。
`*.[].handler`	`String`	映射的处理器。
`*.[].predicate`	`String`	映射的谓词。
`*.[].details.requestMappingConditions`	`Object`	请求映射条件的详细信息。
`*.[].details.requestMappingConditions.consumes`	`Varies`	consumes 条件的详细信息
`*.[].details.requestMappingConditions.consumes.[].mediaType`	`Varies`	消费的媒体类型。
`*.[].details.requestMappingConditions.consumes.[].negated`	`Varies`	媒体类型是否被否定。
`*.[].details.requestMappingConditions.headers`	`Varies`	headers 条件的详细信息。
`*.[].details.requestMappingConditions.headers.[].name`	`Varies`	header 的名称。
`*.[].details.requestMappingConditions.headers.[].value`	`Varies`	header 所需的值（如果有）。
`*.[].details.requestMappingConditions.headers.[].negated`	`Varies`	值是否被否定。
`*.[].details.requestMappingConditions.methods`	`Varies`	处理的 HTTP 方法。
`*.[].details.requestMappingConditions.params`	`Varies`	params 条件的详细信息。
`*.[].details.requestMappingConditions.params.[].name`	`Varies`	参数的名称。
`*.[].details.requestMappingConditions.params.[].value`	`Varies`	参数所需的值（如果有）。
`*.[].details.requestMappingConditions.params.[].negated`	`Varies`	值是否被否定。
`*.[].details.requestMappingConditions.patterns`	`Varies`	标识由该映射处理的路径的模式。
`*.[].details.requestMappingConditions.produces`	`Varies`	produces 条件的详细信息。
`*.[].details.requestMappingConditions.produces.[].mediaType`	`Varies`	生成的媒体类型。
`*.[].details.requestMappingConditions.produces.[].negated`	`Varies`	媒体类型是否被否定。
`*.[].details.handlerMethod`	`Object`	处理此映射请求的方法的详细信息（如果有）。
`*.[].details.handlerMethod.className`	`String`	方法所在类的全限定名。
`*.[].details.handlerMethod.name`	`String`	方法名称。
`*.[].details.handlerMethod.descriptor`	`String`	根据 Java 语言规范指定的方法描述符。
`*.[].details.handlerFunction`	`Object`	处理此映射请求的函数的详细信息（如果有）。
`*.[].details.handlerFunction.className`	`String`	函数所在类的全限定名。

获取映射​

响应结构​

Dispatcher Servlets 响应结构​

Servlets 响应结构​

Servlet 过滤器响应结构​

Dispatcher Handlers 响应结构​