1. 统一错误出口(Servlet || Spring MVC 场景)
Encounter-Freedom
  • ef-auth
    • actuator
      • 获取全部方法
      • 模块详情
      • 获取全部组件健康状态
      • 获取指定类型组件状态
    • 测试 nacos 配置
      • test
      • test
    • 统一错误出口(Servlet || Spring MVC 场景)
      • 统一错误处理入口
        GET
    • 登陆控制器
      • 注册
      • 登录
      • 刷新 Access Token
      • 退出登录
    • 认证用户表(全局账号)(ef_auth_user) 表控制层
      • 获取用户信息
      • 通过电子邮件获取用户信息
      • 通过用户ID获取用户信息
    • 当前登录用户查询接口
      • 获取当前登录用户权限
    • OAuth 风格客户端令牌接口
      • 申请客户端 Access Token
    • JWK Set 公开接口
      • 返回标准格式的 JWK Set JSON
    • 对外暴露当前服务的构建信息
      • 返回当前服务的构建信息
    • 数据模型
      • UserInfoVO
      • RestResponse«List«UserInfoVO»»
      • RestResponse«UserInfoVO»
      • ClientTokenResponse
      • RestResponse«ClientTokenResponse»
      • ClientTokenRequest
      • ResponseEntity«RestResponse«Void»»
      • BuildVersionVO
      • RestResponse«BuildVersionVO»
      • TagVO
      • RestResponse<T>
      • RestResponse«List«TagVO»»
      • NoticeVO
      • RestResponse«NoticeVO»
      • SimpleTagVO
      • ArticleVO
      • PageResult«ArticleVO»
      • RestResponse«PageResult«ArticleVO»»
      • TagInfoVO
      • RestResponse«ArticleArchiveIndexVO»
      • ArticleDetailVO
      • RestResponse«ArticleDetailVO»
      • RestResponse«Boolean»
      • ArticleAccessDTO
      • SimpleArticleVO
      • ArticleNeighborVO
      • RestResponse«ArticleNeighborVO»
      • ArticleMonthVO
      • ArticleArchiveIndexVO
      • RestResponse«List«ArticleArchiveIndexVO»»
      • ArchiveVO
      • RestResponse«List«ArchiveVO»»
      • CommentUserInfo
      • CommentVO
      • RestResponse«List«CommentVO»»
      • CommentPublishVO
      • RestResponse«CommentPublishVO»
      • CommentPublishDTO
      • CommentPageQueryVO
      • PageResult«CommentPageQueryVO»
      • RestResponse«PageResult«CommentPageQueryVO»»
      • CategoryVO
      • RestResponse«List«CategoryVO»»
      • RestResponse«List«String»»
      • RestResponse«String»
      • SiteStatsVO
      • RestResponse«SiteStatsVO»
      • Map«Object»
      • CurrentPermissionVO
      • RestResponse«CurrentPermissionVO»
      • RestResponse«Void»
      • RegisterDTO
      • Token
      • Me
      • Roles
      • LoginVO
      • RestResponse«LoginVO»
      • LoginDTO
      • RestResponse«Token»
      • AuthUser
      • RestResponse«List«AuthUser»»
      • RestResponse«AuthUser»
  • ef-blog
    • actuator
      • 获取全部方法
      • 模块详情
      • 获取全部组件健康状态
      • 获取指定类型组件状态
    • 统一错误出口(Servlet || Spring MVC 场景)
      • 统一错误处理入口
    • 站点配置表(ef_blog_site_config)表控制层
      • 获取站点配置
      • 获取站点统计
    • 博客公告表(ef_blog_notice)表控制层
      • 获取最新的公告
    • 博客背景图表(ef_blog_background)表控制层
      • 获取所有背景图URL
    • 博客文章表(ef_blog_article)表控制层
      • 分页查询文章列表
      • 获取文章详情
      • 验证文章访问密码
      • 获取文章的上一篇/下一篇
      • 获取文章归档列表
      • 根据年/月获取归档文章
    • 博客分类表控制层
      • 查看所有分类
    • 博客标签表控制层
      • 获取热门标签(默认20条)
      • 获取所有标签
    • 博客评论接口
      • 获取最新评论
      • 发布评论
      • 获取文章评论树
    • 对外暴露当前服务的构建信息
      • 返回当前服务的构建信息
    • 数据模型
      • UserInfoVO
      • RestResponse«List«UserInfoVO»»
      • RestResponse«UserInfoVO»
      • ClientTokenResponse
      • RestResponse«ClientTokenResponse»
      • ClientTokenRequest
      • ResponseEntity«RestResponse«Void»»
      • RestResponse<T>
      • BuildVersionVO
      • RestResponse«BuildVersionVO»
      • TagVO
      • RestResponse«List«TagVO»»
      • NoticeVO
      • RestResponse«NoticeVO»
      • SimpleTagVO
      • ArticleVO
      • PageResult«ArticleVO»
      • RestResponse«PageResult«ArticleVO»»
      • TagInfoVO
      • RestResponse«ArticleArchiveIndexVO»
      • ArticleDetailVO
      • RestResponse«ArticleDetailVO»
      • RestResponse«Boolean»
      • ArticleAccessDTO
      • SimpleArticleVO
      • ArticleNeighborVO
      • RestResponse«ArticleNeighborVO»
      • ArticleMonthVO
      • ArticleArchiveIndexVO
      • RestResponse«List«ArticleArchiveIndexVO»»
      • ArchiveVO
      • RestResponse«List«ArchiveVO»»
      • CommentUserInfo
      • CommentVO
      • RestResponse«List«CommentVO»»
      • CommentPublishVO
      • RestResponse«CommentPublishVO»
      • CommentPublishDTO
      • CommentPageQueryVO
      • PageResult«CommentPageQueryVO»
      • RestResponse«PageResult«CommentPageQueryVO»»
      • CategoryVO
      • RestResponse«List«CategoryVO»»
      • RestResponse«List«String»»
      • RestResponse«String»
      • SiteStatsVO
      • RestResponse«SiteStatsVO»
  • ef-gateway
    • actuator
      • 获取全部方法
      • 模块详情
      • 获取全部组件健康状态
      • 获取指定类型组件状态
    • 反向代理入口 Controller(网关核心入口)
      • 网关统一转发入口
    • 网关统一错误出口
      • 错误出口入口方法
    • 对外暴露当前服务的构建信息
      • 返回当前服务的构建信息
    • 数据模型
      • UserInfoVO
      • RestResponse«List«UserInfoVO»»
      • RestResponse«UserInfoVO»
      • ClientTokenResponse
      • RestResponse«ClientTokenResponse»
      • ClientTokenRequest
      • ResponseEntity«RestResponse«Void»»
      • BuildVersionVO
      • RestResponse«BuildVersionVO»
      • RestResponse<T>
  • ef-framework
    • TestController
      • publicPing
      • privatePing
    • Auth 服务 Feign 契约
      • 批量根据用户 ID 获取用户资料
      • 根据用户 ID 获取单个用户资料
      • 根据邮箱获取用户资料
      • 批量根据用户 ID 获取用户资料
      • 根据用户 ID 获取单个用户资料
      • 根据邮箱获取用户资料
    • CacheClient
      • 构建缓存键
      • 获取缓存并转换类型
      • 获取列表缓存并转换为指定元素类型
      • 设置缓存(默认过期时间)
      • 设置缓存(自定义过期时间)
      • 设置缓存(自定义过期时间,指定时间单位)
      • 设置空值缓存(防穿透)
      • 根据缓存键删除缓存
      • CacheClient
    • Auth 令牌接口 Feign 客户端
      • 申请客户端令牌
      • 申请客户端令牌
    • 数据模型
      • UserInfoVO
      • RestResponse«List«UserInfoVO»»
      • RestResponse«UserInfoVO»
      • ClientTokenResponse
      • RestResponse«ClientTokenResponse»
      • ClientTokenRequest
  1. 统一错误出口(Servlet || Spring MVC 场景)

统一错误处理入口

GET
/${server.error.path:/error}

{@code /error} 可能来自多种失败路径(404、参数校验、异常等),不保证是 GET/POST 某一种, 因此使用[Annotation for mapping web requests onto methods in request-handling classes with flexible method signatures.

Both Spring MVC and Spring WebFlux support this annotation through a {@code RequestMappingHandlerMapping} and{@code RequestMappingHandlerAdapter} in their respective modules and package structures. For the exact list of supported handler method arguments and return types in each, please use the reference documentation links below:

  • Spring MVC Method Arguments and Return Values
  • Spring WebFlux Method Arguments and Return Values

NOTE: This annotation can be used both at the class and at the method level. In most cases, at the method level applications will prefer to use one of the HTTP method specific variants {@link GetMapping @GetMapping},{@link PostMapping @PostMapping}, {@link PutMapping @PutMapping},{@link DeleteMapping @DeleteMapping}, or {@link PatchMapping @PatchMapping}.

NOTE: This annotation cannot be used in conjunction with other{@code @RequestMapping} annotations that are declared on the same element (class, interface, or method). If multiple{@code @RequestMapping} annotations are detected on the same element, a warning will be logged, and only the first mapping will be used. This also applies to composed{@code @RequestMapping} annotations such as{@code @GetMapping},{@code @PostMapping}, etc.

NOTE: When using controller interfaces (for example, for AOP proxying), make sure to consistently put all your mapping annotations — such as{@code @RequestMapping} and{@code @SessionAttributes} — on the controller interface rather than on the implementation class.] 以覆盖所有方法

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff 'http://localhost:1111/api/v1/auth/${server.error.path:/error}'

返回响应

🟢200
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "message": "string",
    "messageKey": "string",
    "timestamp": 0,
    "data": null,
    "requestId": "resolveRequestId()"
}
修改于 2026-05-10 10:15:10
上一页
test
下一页
注册
Built with