Spring on I'm company

SpringMVC实践之集成Sentinel限流功能

Fri, 30 Jan 2026 10:48:47 +0800

背景

近期收到线上报警，发现个别新接口在同1s内被请求了接近上百次，对系统的稳定造成了一些影响，近期调研了一下通用的限流框架，打算将Sentinel的限流功能集成进新服务

Sentinel前置知识

Sentinel 限流主要涉及以下几方面

Resource

限流的资源，资源支持动态加载，核心类为： AbstractDataSource ，Sentinel 默认提供了市面常见的资源管理服务的实现，也可以自定义实现

Rule

对定义的 Resouce 应用的限流规则，基于QPS、响应时间与系统负载。Sentinel 是通过一系列的功能Slot来实现不同的统计/控制功能，对于限流功能对应的就是 FlowSlot

FlowSlot 的功能实现需要依赖前面的 NodeSelectorSlot 和 ClusterBuilderSlot 等统计Slot，有了统计信息才可以针对配置进行限流操作，这里面借用一张官方的实现图

各Slot默认的顺序也可以在代码中找到

核心处理逻辑

核心逻辑是在执行调用chain的捕获Blockexcption然后执行后续操作

集成步骤

借助SpringMVC中提供的 HandlerInterceptor 拦截器功能与 Sentinel 提供的SpringMVC框架集成类库可以方便快速的实现限流功能

引入Sentinel SpringMVC Adapter

<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-spring-webmvc-adapter</artifactId>
    <version>1.8.8</version>
</dependency>

配置SentinelWebInterceptor

Sentinel SpringMVC Adapter中提供了 SentinelWebInterceptor 来实现限流功能，这个 Interceptor 支持一些自定义的行为，主要通过 SentinelWebMvcConfig 来实现

SentinelWebMvcConfig 常用配置说明

SentinelWebMvcConfig 支持以下配置能力

urlCleaner

自定义对请求url的处理，比如厂商此次需要通过请求的设备id维度进行限流，对于其它的请求参数都进行忽略，最终可定义效果为: /api/v1/test/ping?did=6308103f1026acf274bbcc1b10001291551xxX

httpMethodSpecify

是否指定特定的Http请求方法，此设置是对资源的请求方法进行了细粒度的配置，默认为false不开启，配置为true后，会在设定好的资源名前加上请求的方法，类似效果: GET: /api/v1/test/ping?did=6308103f1026acf274bbcc1b10001291551xxX

blockExceptionHandler

被Block的请求异常处理器，对Block的请求进行自定义处理，可以设置返回的值，如果未配置则需要服务自己捕获 BlockException，可以通过配置 ExceptionHandler 进行统一处理

originParser

请求来源处理器，针对请求的来源进行处理，在配置资源的规则的可以使用此解析的origin细粒度控制，例如可以解析ip、用户做为请求 origin

Spring学习之@Conditional

Wed, 18 Jun 2025 15:00:00 +0800

注解说明

@Conditional 是 Spring 提供的用于判断是否对 Bean 注入的条件注解(在4.0后版本引入)，只有满足了所有的条件，一个 bean 才会被注册成功并使用。此注解可标注在类上、元注解上、@Bean方法上，通常与 @Configuration 注解配合使用，标识在 @Configuration 注解上的 @Conditional 会影响此配置类的所有 @Bean 注解方法、@Import 注解和@ComponentScan 注解。另需注意 @Conditional 注解不支持继承

对于标注在元注解上的样例，可查看 SpringBoot 项目下的 org.springframework.boot.autoconfigure.condition 包以 ConditionalOn 开头的类

注解属性

此注解只有一个属性 value ，返回类型为 Class 数组，它用来配置所有的 Condition 类信息

Condition 是 Spring 提供的一个接口，它提供了 matches 方法来提供判断的依据逻辑，对于其参数 ConditionContext 提供了丰富的上下文信息

测试代码

@Configuration
@ComponentScan(basePackages = "cn.imcompany.bean.condition")
public class MyConfiguration {

    @Bean
    @ConditionalOnDate
    public MyBean myBean() {
        return new MyBean();
    }

    @Bean
    public MyBean2 myBean2() {
        return new MyBean2();
    }

    @Bean
    @Conditional(ConfigPropertyCondition.class)
    public MyBean5 myBean5() {
        return new MyBean5();
    }
}

@Configuration
@Conditional(ConfigPropertyCondition.class)
public class MyConfigConfiguration {

    @Bean
    public MyBean3 myBean3() {
        return new MyBean3();
    }

    @Bean
    public MyBean4 myBean4() {
        return new MyBean4();
    }
}

public class MyDateCondition implements Condition {

    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {

        LocalDateTime now = LocalDateTime.now();
        int minute = now.getMinute();
        return minute % 2 == 0; // 每隔两分钟满足条件
    }
}

@Retention(java.lang.annotation.RetentionPolicy.RUNTIME)
@Target({java.lang.annotation.ElementType.TYPE, java.lang.annotation.ElementType.METHOD})
@Documented
@Conditional(MyDateCondition.class)
public @interface ConditionalOnDate {
}

public class ConfigPropertyCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        return "true".equals(System.getProperty("my.config.property"));
    }
}

public class Main {

    public static void main(String[] args) {

        System.setProperty("my.config.property", "true");
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(MyConfiguration.class);
        for (String beanDefinitionName : context.getBeanDefinitionNames()) {
            System.out.println("beanDefinitionName = " + beanDefinitionName);
        }
    }
}

源码阅读

对于 Configuration 类条件处理分为两个阶段：

Spring学习之@Bean

Tue, 17 Jun 2025 17:56:39 +0800

注解说明

@Bean 是Spring的一个核心注解，通常与 @Configuration 注解一起使用，用于标记一个方法，方法返回的实体做为Spring管理的一个Bean，通过此注解可以使用JAVA的特性配置对象。默认情况下Bean名字为方法名，也支持通过属性进行配置

属性说明

name

自定义Bean的名称，支持配置多个名称，不配置默认为方法名称

initMethod

配置实例初始化方法，在Bean实例化被调用，默认为空

destroyMethod

配置实例销毁方法，默认值为 (inferred) 即会根据返回的Bean尝试查找识别对象的销毁方法 close 或者 shutdown(限制只查找public无参方法)，如返回一个 BasicDataSource 实例，会默认查找 close() 方法进行注册，如果不想Spring进行此操作，需要将此值设置为: destroyMethod="" (此配置对 DisposableBean 回调不生效)

核心逻辑在 DisposableBeanAdapter#inferDestroyMethodsIfNecessary() 方法中

与其它注解的关联

@Bean 与XML配置方式中的 <bean> 标签不同，它使用与其它注解组合的方式来实现类型 Scope 或者懒加载的功能，具体可组合注解如下：

@Profile
@Scope
@Lazy
@DepednsOn
@Primary
@Order
@Description(给注解bean详细描述，此注解的值会保存在 BeanDefinition 实例上)
@Conditional

接口默认方法定义Bean

Spring 支持在接口中使用默认方法的方式进行bean的定义，方便子类配置类直接复用，示例代码:

public interface BaseConfig {

    @Bean
    default MyBean3 myBean3() {
        return new MyBean3();
    }
}

@Configuration
public class AppConfig implements BaseConfig {
}

源码阅读

Bean注解配置实例化

由于@Bean通常与@Configuration 一起使用，核心逻辑在 refresh 阶段，定位代码发现在 ConfigurationClassParser#doProcessConfigurationClass() 方法进行对 @Bean 标识方法的解析

Spring学习之@Import

Tue, 17 Jun 2025 17:32:55 +0800

注解说明

@Import 注解用于标识多个需要导入的 Component 类，支持导入 @Configuration 类， ImportSelector 与 ImportBeanDefinitionRegistrar 实现，与 AnnotationConfigApplicationContext.register() 方法实现的功能类似。此注解常见的实践方式是标注在 EnableXXXX 注解上，用于开启某些功能，在开启功能时就需要通过 @Import 注解来选择导入哪些类的定义

属性说明

此注解只有一个属性 value，返回 Class[] ，用于标识导入的类

Class类型

@Configuration标识的类

对于不同功能的配置使用多个 @Configuration 标识，由一个类来 Import 另一个类的配置，来达到复用的效果

@Configuration
public class MyConfig2 {

    @Bean
    public MyBeanD myBeanD() {
        return new MyBeanD();
    }
}

@Configuration
@Import({MyConfig2.class})
public class MyConfig {
}

ImportSelector实现类

所有的 ImportSelector 实现都需要实现它的 selectImports 方法，来返回要导入的bean类名称集合

public class MyImportSelector implements ImportSelector {

    @Override
    public String[] selectImports(AnnotationMetadata importingClassMetadata) {
        return new String[]{MyBeanA.class.getName()};
    }
}

在 ImportSelector 可以通过Aware或者构造器注入的方式使用 Spring中的容器组件：

Spring学习之@Value

Tue, 10 Jun 2025 16:00:00 +0800

注解说明

@Value 是Spring提供用于处理属性与表达式注入的注解，可标注在字段、方法或构造器的参数上，并且支持动态解析SpringMVC中的方法参数。支持注入方式：

直接注入如: @Value(“test”)
${my.app.myProp} 属性注入
#{systemProperties.myProp} SpEL表达式

它提供了不同的配置源(属性文件、系统属性)的注入

注解属性

@Value 注解只有一个属性 value ，表示要注入的实际值的表达式，支持属性与SpEL表达式两种方式

测试代码

以下测试代码MyController的username的注入值为: tomyli，而不是配置文件中的admin

@Controller
public class MyController {

    @Value("${USER}")
    @Getter
    private String username;

}

@Configuration
@ComponentScan(basePackages = "cn.imcompany.bean.autowired")
@PropertySource("classpath:application.properties")
public class MyConfiguration {

}

public class Main {

    public static void main(String[] args) {

        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(MyConfiguration.class);
        MyController myController = context.getBean(MyController.class);
        System.out.println(myController.getUsername()); // tomyi
    }
}

application.properties配置文件

USER=admin

源码阅读

@Value 注解的处理由 AutowiredAnnotationBeanPostProcessor 类负责，与处理 @Autowired 注解的类为同一个PostProcessor。主要的处理逻辑实现在 DefaultListableBeanFactory#doResolveDependency 方法，对于 @Value注解的处理主要集中在第2步，解析@Value的操作主要分为3步

Spring学习之@Autowireid

Fri, 06 Jun 2025 16:00:00 +0800

注解说明

@Autowired 是Spring框架的核心注解，用于自动装载构造器、字段、set方法、配置方法上的依赖，它是 JSR-330 @Inject 注解的替代，支持配置 依赖是否必须 选项

属性说明

此注解只有一个属性 required ，默认为 true 表示待注入组件必须存在

注解注入规则说明

构造器注入

如果一个类声明了多个构造器且没有一个显式标注 @Autowired，则Spring会使用默认的构造方法进行装载
如果一个类只声明了一个构造器，不管有没有标注 @Autowired 注解它都会被直接使用
多参数可以配置多个required属性，对于可选注入，可以声明为 Java8 的 Optional 类型

对于可选注入也可以使用 JSR-305 的 javax.annotation.Nullable 注解

字段注入

字段在构造器之后，配置方法注入之前进行自动注入

字段注入支持组件自引用(self references)

方法注入

方法注入不限制方法名与参数个数，所有参数会被Spring进行匹配注入

参数注入

目前只在 spring-test 模块中有效，其它地方使用会被忽略

数组/集合注入

Spring通过匹配数组/集合的值进行注入，Map的key必须为String类型，支持集合中元素的Order配置

不支持 BeanPostProcessor 或者 BeanFactoryPostProcessor

因为真实的注入动作发生在 BeanPostProcessor 阶段，所以不能在 BeanPostProcessor 或者 BeanFactoryPostProcessor 中使用此注解

源码阅读

在Spring中，处理 @Autowired 注解对应的类为 AutowiredAnnotationBeanPostProcessor ，又是一个Bean后置处理器

对于此类，需要关注其实现的两个接口类 MergedBeanDefinitionPostProcessor (运行时合并Bean的定义回调接口)和 InstantiationAwareBeanPostProcessor (在Bean实例化前后进行处理后置处理器)

MergedBeanDefinitionPostProcessor 主要是为了在真正bean实例化前准备缓存的bean元数据

InstantiationAwareBeanPostProcessor Bean实例化回调接口，通常用于为bean创建代理

测试代码

@Service
public class MyService {

}

@Controller
public class MyController {

    @Autowired
    MyService myService;

    public void showService() {
        System.out.println("myService = " + myService);
    }
}

@Configuration
@ComponentScan(basePackages = "cn.imcompany.bean.autowired")
public class MyConfiguration {

}

public class Main {

    public static void main(String[] args) {

        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(MyConfiguration.class);
        MyController myController = context.getBean(MyController.class);
        myController.showService();
    }
}

元数据收集

调用栈信息如下：

Spring学习之@CompnentScan

Thu, 15 May 2025 16:29:33 +0800

注解说明

@ComponentScan 注解是Spring 提供的对组件进行扫描的注解指令，通常与 @Configuration 注解一起使用，支持在类上重复标注

注解能做什么？

此注解支持以下重要特性:

自定义扫描的包范围
配置包含扫描组件的过滤器
配置排除组件的过滤器
是否使用默认过滤器
是否配置懒加载

源码分析

由于此注解通常与 @Configuration 注解一起使用，其解析的主要逻辑都是在 refresh 阶段的 invokeBeanFactoryPostProcessors 方法中，最终会定位到 ConfigurationClassParser#doProcessConfigurationClass() 方法中，在方法中可以看到对 ComponentScan 注解的操作逻辑了

对注解属性的解析

所有对属性的解析都在 ComponentScanAnnotationParser#parse() 方法中进行，此方法中会创建一个 ClassPathBeanDefinitionScanner 实例scanner，此实例初始化过程中会对默认的Filter进行加载

处理默认Filter主要是 JSR-250 与 JSR-330 API 增加的注解

然后会把配置的 includeFilter 和 excludeFilter 设置到 scanner 中，接着会对 basePackage 扫描包属性进行解析配置，如果配置了就添加，没有配置，默认就使用 @ComponentScan 注解标注类所在的包路径。解析完注解属性后，就开始了真正的扫描操作

扫描操作

扫描操作由 ClassPathBeanDefinitionScanner#doScan() 方法进行处理，此方法会调用 findCandidateComponents() 方法在给定的包下查找符合条件的组件，查找的任务由 scanCandidateComponents() 进行，该方法调用 isCandidateComponent() 方法，根据解析的includeFilter和excludeFilter 来选择满足条件的组件

这样扫描到所有满足条件的Bean后，会接着对这些Bean进行parse操作，直到注解再无其它依赖

注册Bean

扫描完所有Bean后，会调用 checkCandidate() 方法进行检查，检查当前要注册的Bean是否与已经注册过的Bean的定义是否兼容，如果冲突会报 ConflictingBeanDefinitionException 。检查没问题后，会调用 registerBeanDefinition() 方法对Bean进行注册，这个过程就涉及到Spring其它的生命周期了（这个后续专门学习总结），对于@ComponentScan 组件来说已经完成了它的使命

总结

最后以注解解析过程中的涉及的核心类做一下总结

常见问题

调整包结构后一些@Bean配置扫描不到了

调用启动类的包路径为最外层，这样可以扫描当前包及子包的配置
默认只扫描当前标注注解的包，可以通过配置 basePackage 属性指定扫描路径，配置后默认的扫描路径就不生效了

如何将未配置Spring相关组件注解的Bean纳入Spring管理?

可以通过配置 ComponentScan的includeFilter 来实现

Spring学习之@Configuration

Fri, 09 May 2025 11:40:11 +0800

@Configuration是什么？

@Configuration 是 Spring提供的一个用于配置与声明Bean与相应Bean之间依赖的注解，根据文档描述，此注解通常由 AnnotationConfigApplicationContext 上下文进行启动加载

@Configuration能做什么？

先看一下此注解的声明，在此注解上标识了 @Component ，则证明此注解是一个 Component，拥有 @Component 注解的基础能力(可以被Spring容器自动扫描与加载)

上图标识了注解常用的配置方式，分类为以下几种

属性资源导入
引入其它配置类的配置
Value注入
Spring容器组件注入
支持Profile配置

注解属性

在Spring5.x版本中，只支持两个属性配置

value

配置注解的名称

proxyBeanMethods

是否代理增强(基于CGLIB)标识 @Bean 的方法，默认为true，保证声明的bean是单例共享的，而不是每一次通过方法调用都生成一个新的

此属性的两个值被定义为两种模式

full 模式(值为true)
lite 模式(值为false)

源码分析

@Configuration 注解的解析类为 ConfigurationClassPostProcessor ，本次主要关注从 AnnotationConfigApplicationContext 启动后的整个处理过程， AnnotationConfigApplicationContext 启动分为三个阶段

先上一张三个阶段的涉及的主要类与调用关系图

初始化

初始化reader

此过程会实例化 AnnotatedBeanDefinitionReader 类，此类在实例化时会调用 AnnotationConfigUtils.registerAnnotationConfigProcessors 来注册解析配置的Processor，如果registry中没有包含 ConfigurationClassPostProcessor 类的定义，则会新new一个 ConfigurationClassPostProcessor 的Bean定义类

整体调用链路如下：

初始化scanner

此过程会实例化Bean定义扫描器 ClassPathBeanDefinitionScanner , 在此过程中主要会设置 Environment 和 ResourceLoader 相关信息

注册

注册阶段主要是对标注了 @Configuration 类(MyConfig)进行注册，以便Spring可以正常识别，主要逻辑在 AnnotatedBeanDefinitionReader#doRegisterBean 中，此方法会调用 BeanDefinitionReaderUtils.registerBeanDefinition 对此Bean进行注册

至此， @Configuration 类信息就注册到了 Spring 容器中

SpringMVC实践之集成Sentinel限流功能

Fri, 25 Apr 2025 17:53:54 +0800

背景

Sentinel前置知识

Sentinel 限流主要涉及以下几方面

Resource

限流的资源，资源支持动态加载，核心类为： AbstractDataSource ，Sentinel 默认提供了市面常见的资源管理服务的实现，也可以自定义实现

Rule

各Slot默认的顺序也可以在代码中找到

核心处理逻辑

核心逻辑是在执行调用chain的捕获Blockexcption然后执行后续操作

集成步骤

借助SpringMVC中提供的 HandlerInterceptor 拦截器功能与 Sentinel 提供的SpringMVC框架集成类库可以方便快速的实现限流功能

引入Sentinel SpringMVC Adapter

<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-spring-webmvc-adapter</artifactId>
    <version>1.8.8</version>
</dependency>

配置SentinelWebInterceptor

Sentinel SpringMVC Adapter中提供了 SentinelWebInterceptor 来实现限流功能，这个 Interceptor 支持一些自定义的行为，主要通过 SentinelWebMvcConfig 来实现

SentinelWebMvcConfig 常用配置说明

SentinelWebMvcConfig 支持以下配置能力

urlCleaner

自定义对请求url的处理，比如厂商此次需要通过请求的设备id维度进行限流，对于其它的请求参数都进行忽略，最终可定义效果为: /api/v1/test/ping?did=6308103f1026acf274bbcc1b10001291551xxX

httpMethodSpecify

是否指定特定的Http请求方法，此设置是对资源的请求方法进行了细粒度的配置，默认为false不开启，配置为true后，会在设定好的资源名前加上请求的方法，类似效果: GET: /api/v1/test/ping?did=6308103f1026acf274bbcc1b10001291551xxX

blockExceptionHandler

被Block的请求异常处理器，对Block的请求进行自定义处理，可以设置返回的值，如果未配置则需要服务自己捕获 BlockException，可以通过配置 ExceptionHandler 进行统一处理

originParser

请求来源处理器，针对请求的来源进行处理，在配置资源的规则的可以使用此解析的origin细粒度控制，例如可以解析ip、用户做为请求 origin

SpringMVC学习之HandlerMapping

Fri, 18 Apr 2025 11:27:45 +0800

起因

新服务在处理不存在的url请求时，上报日志报错，具体错误信息：

根据报错信息找到相关代码

代码处做了对参数hanler的强制转换，但是真正传入的参数类型为 ResourceHttpRequestHandler 导致转换失败而报错，梳理一下，handler是在自定义的日志Interceptor 的afterCompletion方法中由框架传入的

ResourceHttpRequestHandler 是什么?

查阅类文档，ResourceHttpRequestHandler是SpringMVC提供的处理静态资源的Handler，比如常见的js或者css文件。在当前前后端分离的分工下，对于REST服务开发，不会再使用这种方式提供对静态资源的访问，为什么请求了一个不存在的url，会使用静态资源的Hanlder来处理?

SpringMVC提供了哪些HandlerMapping?

SpringMVC提供的HanlderMapping位于 org.springframework.web.servlet.handler 包下，主要包含

Mapping	Desc
RequestMappingHandlerMapping	处理@RequestMapping 注解映射关系
SimpleUrlHandlerMapping	使用URL模式匹配映射关系
BeanNameUrlHandlerMapping	基于Bean名匹配映射关系

SpringMVC 路径映射流程回顾

回顾一下SpringMVC的路径映射流程，通常的url请求的编码方式为:

@RequestMapping("/ping")
public Response<String> ping() {
    return Response.success("pong");
}

标识了 @RequestMapping 注解的方法会被 SpringMVC 框架的 RequestMappingHandlerMapping 类在启动时进行扫描并根据映射信息来创建 RequestMappingInfo(RequestMappingInfo 类维护请求的映射信息)，扫描后的所有Mapping信息在 MappingRegistry(AbstractHandlerMethodMapping内部类) 类进行维护

SpringMVC如何处理request与HandlerMethod的映射关系

AbstractHandlerMethodMapping的getHandler 方法用来通过给定的request来找到一个合适的handler进行处理

getHandler会先调用抽象方法 getHandlerInternal 由子类实现查找逻辑，如果找不到，则查找默认配置的Hanlder，默认Hanlder找不到则返回null

SpringMVC默认使用了哪些HandlerMapping

如何查询Handler是在 DispacherServlet的getHandler方法操作的，它会在所有的handlerMappings(有序handlerMapping)中查找出一个可用的handler进行request的处理

如图可知会在7个handlerMapping中依次进行查询，这些handlerMapping是在 DispatcherServlet#initHandlerMappings() 设置的

定位到问题原因

跟踪请求代码发现对于不存在的url会在 SimpleUrlHanlderMapping中找到可用的handler，因为最终请求url匹配上了 /**，而 /** 模式对应的handler就是 ResourceHttpRequestHandler，此时getHandler的结果就是ResourceHttpRequestHandler 了，但是在上报时使用的是 HandlerMethod，执行到此时报了转换异常

WebMvcAutoConfiguration中的SourceHandler在哪注册的？

在启用MVC功能时，会增加注解 @EnableWebMvc，而对应的MVC配置类为 WebMvcConfigurationSupport，在这个类中进行SourceHandler的注册。跟踪代码发现两个ResourceHandler是在 WebMvcAutoConfigurationAdapter中添加的

SpringMVC学习之Exception处理

Mon, 14 Apr 2025 11:04:00 +0800

背景

开发过程中，会出现很多异常情况，比如RPC调用异常、请求参数异常，SpringMVC是如何处理异常信息的?

Spring处理异常的方式

Spring采用了全局的异常捕获统一处理的方式，虽然JAVA的异常机制一直有争议，但是Spring还是选择基于实际开发需要使用抛异常后捕获统一处理的方式

HandlerExceptionResolver登场

HandlerExceptionResolver 是SpringMVC提供的解析Handler调用过程抛出异常的解析器，只提供了一个解析异常的方法 resovleException

Spring提供了哪些ExceptionResolver?

经典的Interface-Abstract方式的实现类

Resolver	Desc
SimpleMappingExceptionResolver	提供exception class name到view的映射
DefaultHandlerExceptionResolver	默认Resolver实现，用于解析标准的SpringMVC异常并转换成对应的Http状态码
ResponseStatusExceptionResolver	基于 @ResponseStatus 注解来映射异常与Http状态码
ExceptionHandlerExceptionResolver	基于 @ExceptionHalder 注解来解析处理异常信息

直接实现HandlerExceptionResolver的类

Resolver	Desc
DefaultErrorAttributes	默认错误属性实现
HandlerExceptionResolverComposite	代理其它Resolver集合的ExceptionResolver

HandlerExceptionResolverComposite 中包含了一个解析列表，可以判断是会排序后顺序调用，以找到第一个可以处理的Resolver

具体异常处理流程

异常处理的核心逻辑都在 processHandlerException 方法中，Spring处理完请求后，如果有异常抛出，则会把异常信息传给 processHandlerException 方法， processHandlerException 遍历持有的 handlerExceptionResolvers 进行对异常的解析，如果解析成功则直接返回对应的 ModelAndView(此返回与正常的handler处理返回保持了一致)

handlerExceptionResolvers 有哪些？

在 SpringMVC启动时会调用 initHandlerExceptionResolvers 方法来查找所有可用的 handlerExceptionResolver 并保存到 handlerExceptionResolvers 变量中。SpringMVC配置了两个 resolver 来提供异常解析

errorAttributes

此Resolver是在 ErrorMvcAutoConfiguration 进行实例化的

此实现的 resolverExcption 方法逻辑简单，直接返回了null，不是关注重点

handlerExceptionResolver

此Resolver真正的实现类为 HandlerExceptionResolverComposite ，也就是持有多个ExceptionResolver列表的 Resolver，它是在 WebMvcConfigurationSupport 实例化的

SpringMVC统一配置接口WebMvcConfigurer功能

Fri, 28 Mar 2025 18:18:10 +0800

接口说明

WebMvcConfigurer是Spring提供的统一配置接口，用于自定义Spring MVC的配置，全局更改服务的行为，提供的可配置项：

关联类

WebMvcConfigurationSupport

EnableWebMvc

接口常用方法

接口提供了将近20个方法对Spring的配置进行调整，本次只针对常用的Rest接口开发相关内容进行展开学习研究

基于Spring initializr实现自己的项目模板

Tue, 15 Oct 2024 17:44:29 +0800

介绍

先前通过 Apache Maven Archetype 生成了一个项目脚手架1.0版本，模板比较固定，无法根据需要进行灵活定制，经过调研后，发现可基于Spring Starter项目进行定制，脚手架2.0版本也就应运而生。

目标

快速创建最小可运行工程
基础组件依赖管理
1. 版本管理
2. 帮助信息
按需生成项目结构

最终效果

实现

主流程

获取配置

通过请求服务根路径获取脚手架信息，对应接口代码

如请求: http://localhost:8080 会返回以下内容信息

接口返回了服务支持配置的元数据信息

生成工程代码

用户选择配置相应功能后，点击生成按钮，会调用 http://localhost:8080/start.zip 接口将配置信息传给服务，服务根据信息生成代码

核心功能实现

项目工程由以下几方面组成:

application.yml文件
工程目录(controller, servier…)
auto_publish相关目录
trpc_java.yaml文件
配置相关
1. 日志配置文件
web服务相关
1. httpApi接口
2. httpApi实现类StartController
Maven依赖管理
主启动程序自定义
测试辅助开发相关自定义
1. applicationTest

依赖管理

根据现有常用的 Peacock 框架功能包，依赖管理配置以下模块:

Starter
Integration
Provider
Data
Testing
MQ
Job

实践

生成一个最小可运行Web应用

命令行快速生成

curl -L 'http://localhost:8080/start.zip?type=peacock-project&bootVersion=1.5.7.RELEASE&groupId=com.yuewen.bookcoop&artifactId=solution_demo&name=solution_demo101&version=1.0.0-SNAPSHOT&language=java&packageName=com.yuewen.bookcoop.solution_demo&javaVersion=1.8&packaging=jar&description=solution_demo101&dependencies=integration-web&dependencies=peacock-test&dependencies=integration-common&dependencies=starter' -o solution_demo.zip

具体的依赖库元信息可以在根路径下请求获得，具体依赖信息为dependencies值对应id的值

IDEA中生成

Idea配置脚手架地址

使用本地地址如: http://localhost:8080

配置工程信息

填写好相关的业务信息与版本信息

选择依赖模块

Web应用需选择以下模块:

Peacock Trpc Starter
Integration Web
Integration Common
Peacock Test

选择完成后点击生成按钮生成代码

记一次SpringWebflux框架下堆外OOM排查经历

Thu, 31 Mar 2022 20:12:23 +0800

症状

生产环境业务页面打不开，看错误日志是 OutOfDirectMemoryError (OOM)了，详情报错信息如下：

2022-03-21 06:00:00.541 [,] [tafprx-asyrecv_9] ERROR r.c.p.Operators - [error,314] - Operator called default onErrorDropped
java.lang.OutOfMemoryError: Direct buffer memory
        at java.base/java.nio.Bits.reserveMemory(Bits.java:175)
        at java.base/java.nio.DirectByteBuffer.<init>(DirectByteBuffer.java:118)
        at java.base/java.nio.ByteBuffer.allocateDirect(ByteBuffer.java:317)
        at io.netty.buffer.PoolArena$DirectArena.allocateDirect(PoolArena.java:632)
        at io.netty.buffer.PoolArena$DirectArena.newChunk(PoolArena.java:607)
        at io.netty.buffer.PoolArena.allocateNormal(PoolArena.java:202)
        at io.netty.buffer.PoolArena.tcacheAllocateSmall(PoolArena.java:172)
        at io.netty.buffer.PoolArena.allocate(PoolArena.java:134)
        at io.netty.buffer.PoolArena.allocate(PoolArena.java:126)
        at io.netty.buffer.PooledByteBufAllocator.newDirectBuffer(PooledByteBufAllocator.java:395)
        at io.netty.buffer.AbstractByteBufAllocator.directBuffer(AbstractByteBufAllocator.java:187)
        at io.netty.buffer.AbstractByteBufAllocator.directBuffer(AbstractByteBufAllocator.java:178)
        at io.netty.buffer.AbstractByteBufAllocator.buffer(AbstractByteBufAllocator.java:115)
        at org.springframework.core.io.buffer.NettyDataBufferFactory.allocateBuffer(NettyDataBufferFactory.java:71)
        at org.springframework.core.io.buffer.NettyDataBufferFactory.allocateBuffer(NettyDataBufferFactory.java:39)
        at org.springframework.http.codec.json.AbstractJackson2Encoder.encodeValue(AbstractJackson2Encoder.java:236)
        at org.springframework.http.codec.json.AbstractJackson2Encoder.lambda$encode$0(AbstractJackson2Encoder.java:150)
        at reactor.core.publisher.FluxMapFuseable$MapFuseableSubscriber.onNext(FluxMapFuseable.java:113)
        at reactor.core.publisher.Operators$MonoSubscriber.complete(Operators.java:1815)
        at reactor.core.publisher.MonoCompletionStage.lambda$subscribe$0(MonoCompletionStage.java:82)
        at java.base/java.util.concurrent.CompletableFuture.uniWhenComplete(CompletableFuture.java:859)
        at java.base/java.util.concurrent.CompletableFuture.uniWhenCompleteStage(CompletableFuture.java:883)
        at java.base/java.util.concurrent.CompletableFuture.whenComplete(CompletableFuture.java:2251)
        at java.base/java.util.concurrent.CompletableFuture.whenComplete(CompletableFuture.java:143)
        at reactor.core.publisher.MonoCompletionStage.subscribe(MonoCompletionStage.java:57)
        at reactor.core.publisher.InternalMonoOperator.subscribe(InternalMonoOperator.java:64)
        at reactor.core.publisher.MonoFlatMap$FlatMapMain.onNext(MonoFlatMap.java:157)
        at reactor.core.publisher.Operators$MonoSubscriber.complete(Operators.java:1815)
        at reactor.core.publisher.MonoFlatMap$FlatMapInner.onNext(MonoFlatMap.java:249)
        at reactor.core.publisher.FluxOnErrorResume$ResumeSubscriber.onNext(FluxOnErrorResume.java:79)
        at reactor.core.publisher.FluxPeek$PeekSubscriber.onNext(FluxPeek.java:199)
        at reactor.core.publisher.FluxPeek$PeekSubscriber.onNext(FluxPeek.java:199)
        at reactor.core.publisher.MonoIgnoreThen$ThenIgnoreMain.complete(MonoIgnoreThen.java:284)
        at reactor.core.publisher.MonoIgnoreThen$ThenIgnoreMain.onNext(MonoIgnoreThen.java:187)
        at reactor.core.publisher.Operators$MonoSubscriber.complete(Operators.java:1815)
        at reactor.core.publisher.MonoFlatMap$FlatMapMain.onNext(MonoFlatMap.java:151)

根据报错的堆栈，找到 AbstractJackson2Encoder:236 行，调试发现框架使用的buffer在最后都进行了释放，看着没问题。

方法名称	参数	用途
addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers)	List<HandlerMethodArgumentResolver> argumentResolvers	添加自定义的 HandlerMethodArgumentResolver 用于解析方法参数。
addCorsMappings(CorsRegistry registry)	CorsRegistry registry	配置跨域资源共享 (CORS)
addFormatters(FormatterRegistry registry)	FormatterRegistry registry	添加自定义的格式化程序和转换器
addInterceptors(InterceptorRegistry registry)	InterceptorRegistry registry	添加自定义的拦截器
addRequestMappings(RequestMappingInfo customization, Class<Controller> controllerClass)	RequestMappingInfo customization, Class<Controller> controllerClass	关联自定义请求映射到具控制器类
addResourceHandlers(ResourceHandlerRegistry registry)	ResourceHandlerRegistry registry	配置资源处理，如静态资源路径
addReturnValueHandlers(List<HandlerMethodReturnValueHandler> returnValueHandlers)	List<HandlerMethodReturnValueHandler> returnValueHandlers	添加自定义的 HandlerMethodReturnValueHandler 用于处理方法返回值
addViewControllers(ViewControllerRegistry registry)	ViewControllerRegistry registry	注册视图控制器
configureAsyncSupport(AsyncSupportConfigurer configurer)	AsyncSupportConfigurer configurer	配置异步支持
configureContentNegotiation(ContentNegotiationConfigurer configurer)	ContentNegotiationConfigurer configurer	配置内容协商策略
configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)	DefaultServletHandlerConfigurer configurer	启用默认 Servlet 处理
configureHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers)	List<HandlerExceptionResolver> exceptionResolvers	配置异常处理程序
configureMessageConverters(List<HttpMessageConverter<?>> converters)	List<HttpMessageConverter<?>> converters	配置自定义的 HttpMessageConverter
configurePathMatch(PathMatchConfigurer configurer)	PathMatchConfigurer configurer	配置路径匹配规则
configureViewResolvers(ViewResolverRegistry registry)	ViewResolverRegistry registry	配置视图解析器
extendHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers)	List<HandlerExceptionResolver> exceptionResolvers	扩展异常处理程序
extendMessageConverters(List<HttpMessageConverter<?>> converters)	List<HttpMessageConverter<?>> converters	扩展自定义的 HttpMessageConverter
extendInterceptors(List<HandlerInterceptor> interceptors)	List<HandlerInterceptor> interceptors	扩展拦截器
extendArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers)	List<HandlerMethodArgumentResolver> argumentResolvers	扩展自定义的 HandlerMethodArgumentResolver 用于解析方法参数。
extendReturnValueHandlers(List<HandlerMethodReturnValueHandler> returnValueHandlers)	List<HandlerMethodReturnValueHandler> returnValueHandlers	扩展自定义的 HandlerMethodReturnValueHandler 用于处理方法返回值。
extendViewResolvers(List<ViewResolver> viewResolvers)	List<ViewResolver> viewResolvers	扩展视图解析器