1. Spring Boot项目创建时的核心依赖解析刚接触Spring Boot时最让人困惑的就是pom.xml里那一大堆依赖项。作为从SSH时代走过来的老Javaer我深刻理解这种面对未知依赖的恐惧感。Spring Boot通过starter机制简化了依赖管理但选择适合的starter本身就是门学问。本文将基于我参与过的17个企业级Spring Boot项目经验拆解那些真正高频使用的核心依赖。Spring Boot的starter依赖可以理解为功能套餐——每个starter都打包了一组特定功能所需的全部jar包。比如引入spring-boot-starter-web就自动包含了Spring MVC、Tomcat和Jackson等Web开发必备组件。这种设计让依赖管理从手动配零件升级为整车采购但前提是你要清楚每辆车的性能和用途。2. Web开发必选依赖2.1 基础Web支持dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency这是构建Web应用的基石包含Spring MVC框架内嵌Tomcat默认服务器Jackson JSON处理器验证框架Hibernate Validator实际项目中我建议配合以下依赖使用dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency这个经常被忽略的依赖提供了更强大的参数校验能力比如NotBlank、Email等注解支持。2.2 RESTful API增强对于现代API开发我会额外添加dependency groupIdio.springfox/groupId artifactIdspringfox-boot-starter/artifactId version3.0.0/version /dependency配合Knife4j可以生成漂亮的API文档dependency groupIdcom.github.xiaoymin/groupId artifactIdknife4j-spring-boot-starter/artifactId version3.0.3/version /dependency重要提示Spring Boot 2.6版本需要额外配置路径匹配策略否则会与Swagger冲突spring.mvc.pathmatch.matching-strategyANT_PATH_MATCHER3. 数据持久化方案选型3.1 关系型数据库JPA是大多数项目的首选dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency搭配数据库驱动比如MySQLdependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency对于复杂查询场景MyBatis更灵活dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency3.2 NoSQL解决方案Redis缓存几乎是标配dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-redis/artifactId /dependency记得配置缓存空值处理Cacheable(value users, unless #result null) public User getUserById(Long id) { //... }MongoDB依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-mongodb/artifactId /dependency4. 系统集成与消息队列4.1 RabbitMQ集成dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-amqp/artifactId /dependency配置示例spring.rabbitmq.hostlocalhost spring.rabbitmq.port5672 spring.rabbitmq.usernameguest spring.rabbitmq.passwordguest4.2 WebSocket支持实时通信场景必备dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-websocket/artifactId /dependency需要配合配置类Configuration EnableWebSocket public class WebSocketConfig implements WebSocketConfigurer { Override public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) { registry.addHandler(myHandler(), /ws).setAllowedOrigins(*); } Bean public WebSocketHandler myHandler() { return new MyWebSocketHandler(); } }5. 安全与监控5.1 Spring Security基础安全防护dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /versionOAuth2客户端配置Configuration public class OAuth2LoginConfig { Bean public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { http .authorizeHttpRequests(auth - auth .anyRequest().authenticated() ) .oauth2Login(withDefaults()); return http.build(); } }5.2 Actuator监控dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency安全加固配置management.endpoints.web.exposure.includehealth,info management.endpoint.health.show-detailswhen_authorized6. 测试与开发工具6.1 测试套件dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependencyMockMVC测试示例SpringBootTest AutoConfigureMockMvc class UserControllerTest { Autowired private MockMvc mockMvc; Test void shouldReturnUser() throws Exception { mockMvc.perform(get(/users/1)) .andExpect(status().isOk()) .andExpect(jsonPath($.name).value(John)); } }6.2 开发期工具热部署神器dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId scoperuntime/scope optionaltrue/optional /dependencyLombok简化代码dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency7. 企业级项目经验谈在实际企业开发中我发现这些组合最常见Web应用标准套件web security >mvn dependency:tree -Dincludes:spring-core这个命令可以快速定位冲突的依赖项。最后分享一个真实案例在某金融项目中我们因为同时引入了spring-boot-starter-json和gson导致Jackson序列化失效。解决方案是排除gson依赖exclusions exclusion groupIdcom.google.code.gson/groupId artifactIdgson/artifactId /exclusion /exclusions
1. Spring Boot项目创建时的核心依赖解析刚接触Spring Boot时最让人困惑的就是pom.xml里那一大堆依赖项。作为从SSH时代走过来的老Javaer我深刻理解这种面对未知依赖的恐惧感。Spring Boot通过starter机制简化了依赖管理但选择适合的starter本身就是门学问。本文将基于我参与过的17个企业级Spring Boot项目经验拆解那些真正高频使用的核心依赖。Spring Boot的starter依赖可以理解为功能套餐——每个starter都打包了一组特定功能所需的全部jar包。比如引入spring-boot-starter-web就自动包含了Spring MVC、Tomcat和Jackson等Web开发必备组件。这种设计让依赖管理从手动配零件升级为整车采购但前提是你要清楚每辆车的性能和用途。2. Web开发必选依赖2.1 基础Web支持dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency这是构建Web应用的基石包含Spring MVC框架内嵌Tomcat默认服务器Jackson JSON处理器验证框架Hibernate Validator实际项目中我建议配合以下依赖使用dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency这个经常被忽略的依赖提供了更强大的参数校验能力比如NotBlank、Email等注解支持。2.2 RESTful API增强对于现代API开发我会额外添加dependency groupIdio.springfox/groupId artifactIdspringfox-boot-starter/artifactId version3.0.0/version /dependency配合Knife4j可以生成漂亮的API文档dependency groupIdcom.github.xiaoymin/groupId artifactIdknife4j-spring-boot-starter/artifactId version3.0.3/version /dependency重要提示Spring Boot 2.6版本需要额外配置路径匹配策略否则会与Swagger冲突spring.mvc.pathmatch.matching-strategyANT_PATH_MATCHER3. 数据持久化方案选型3.1 关系型数据库JPA是大多数项目的首选dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency搭配数据库驱动比如MySQLdependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency对于复杂查询场景MyBatis更灵活dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency3.2 NoSQL解决方案Redis缓存几乎是标配dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-redis/artifactId /dependency记得配置缓存空值处理Cacheable(value users, unless #result null) public User getUserById(Long id) { //... }MongoDB依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-mongodb/artifactId /dependency4. 系统集成与消息队列4.1 RabbitMQ集成dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-amqp/artifactId /dependency配置示例spring.rabbitmq.hostlocalhost spring.rabbitmq.port5672 spring.rabbitmq.usernameguest spring.rabbitmq.passwordguest4.2 WebSocket支持实时通信场景必备dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-websocket/artifactId /dependency需要配合配置类Configuration EnableWebSocket public class WebSocketConfig implements WebSocketConfigurer { Override public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) { registry.addHandler(myHandler(), /ws).setAllowedOrigins(*); } Bean public WebSocketHandler myHandler() { return new MyWebSocketHandler(); } }5. 安全与监控5.1 Spring Security基础安全防护dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /versionOAuth2客户端配置Configuration public class OAuth2LoginConfig { Bean public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { http .authorizeHttpRequests(auth - auth .anyRequest().authenticated() ) .oauth2Login(withDefaults()); return http.build(); } }5.2 Actuator监控dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency安全加固配置management.endpoints.web.exposure.includehealth,info management.endpoint.health.show-detailswhen_authorized6. 测试与开发工具6.1 测试套件dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependencyMockMVC测试示例SpringBootTest AutoConfigureMockMvc class UserControllerTest { Autowired private MockMvc mockMvc; Test void shouldReturnUser() throws Exception { mockMvc.perform(get(/users/1)) .andExpect(status().isOk()) .andExpect(jsonPath($.name).value(John)); } }6.2 开发期工具热部署神器dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId scoperuntime/scope optionaltrue/optional /dependencyLombok简化代码dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency7. 企业级项目经验谈在实际企业开发中我发现这些组合最常见Web应用标准套件web security >mvn dependency:tree -Dincludes:spring-core这个命令可以快速定位冲突的依赖项。最后分享一个真实案例在某金融项目中我们因为同时引入了spring-boot-starter-json和gson导致Jackson序列化失效。解决方案是排除gson依赖exclusions exclusion groupIdcom.google.code.gson/groupId artifactIdgson/artifactId /exclusion /exclusions
