基于Spring Boot构建Java类库是否可行？求相关建议

问题根源 #

你遇到的自定义注解失效问题，本质是手动new出来的服务实例不在Spring容器管理范围内——Spring的注解增强（比如AOP、自定义BeanPostProcessor）只对容器内的Bean生效，手动实例化的对象不会触发这些逻辑。

可行性结论 #

Spring Boot完全可以用来构建通用JVM类库，但要区分「面向Spring生态的类库」和「跨JVM通用类库」的设计边界：如果要兼容非Spring应用，必须弱化对Spring容器的强依赖。

具体解决方案 #

1. 拆分注解逻辑，提供双模式实现 #

• 如果自定义注解依赖Spring的AOP或Bean生命周期，为非Spring环境单独实现一套替代逻辑：
  • 比如把Spring AOP实现的注解改成AspectJ编译时织入，无需Spring容器也能生效；
  • 或者手动用JDK动态代理/ASM实现注解的增强逻辑，在工厂类创建实例时自动为对象生成代理。
• 为服务类提供两种使用方式：Spring容器托管版（依赖Spring注解）和纯Java版（自带代理逻辑），让用户按需选择。

2. 优化工厂类，兼容Spring与非Spring环境 #

修改工厂类，使其能自动检测Spring上下文是否存在，优先使用容器内的Bean，否则手动实例化（并注入替代的注解增强逻辑）：

import org.springframework.context.ApplicationContext;
import org.springframework.context.ApplicationContextAware;
import org.mapstruct.factory.Mappers;

public class ServiceFactory implements ApplicationContextAware {
    private static ApplicationContext context;
    private static final FooMapper fooMapper = Mappers.getMapper(FooMapper.class);
    private static final BarMapper barMapper = Mappers.getMapper(BarMapper.class);

    public static FooService createFooService() {
        // 如果存在Spring上下文，直接取容器中的Bean
        if (context != null && context.containsBean(FooService.class)) {
            return context.getBean(FooService.class);
        }
        // 非Spring环境，手动实例化并注入代理增强
        FooService rawService = new FooService(fooMapper, barMapper);
        return wrapWithAnnotationEnhance(rawService);
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) {
        ServiceFactory.context = applicationContext;
    }

    // 自定义方法：为纯Java实例添加注解逻辑的代理增强
    private static FooService wrapWithAnnotationEnhance(FooService service) {
        return (FooService) java.lang.reflect.Proxy.newProxyInstance(
            service.getClass().getClassLoader(),
            service.getClass().getInterfaces(),
            (proxy, method, args) -> {
                // 模拟自定义注解的处理逻辑
                if (method.isAnnotationPresent(YourCustomAnnotation.class)) {
                    // 执行注解对应的增强操作
                }
                return method.invoke(service, args);
            }
        );
    }
}

3. 调整测试策略 #

• 针对纯Java模式：编写不依赖Spring的单元测试，直接用工厂类创建实例，验证注解的非Spring实现逻辑；
• 针对Spring集成模式：用@SpringBootTest测试容器托管的服务实例，确保Spring注解逻辑正常；
• 如果某些注解只能依赖Spring，明确在文档中标注这些特性仅支持Spring环境。

4. 类库打包与依赖管理 #

• 避免使用Spring Boot的spring-boot-maven-plugin打包，改用标准的maven-jar-plugin，生成普通可依赖Jar包；
• 将Spring相关依赖设为optional或provided，避免强制用户引入Spring容器：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter</artifactId>
      <optional>true</optional>
  </dependency>
  

后续潜在问题与规避 #

• 依赖冲突：用dependencyManagement统一Spring相关依赖版本，或仅引入必要的Spring模块而非完整starter；
• 类加载问题：确保纯Java模式的代码不依赖Spring类，避免干扰非Spring应用的类加载；
• 文档清晰性：明确告知用户类库的两种使用场景及对应限制，避免误解。

内容的提问来源于stack exchange，提问作者vic