干货合集：Spring Boot 使用技巧，让你的开发效率飙升！

2024-11-22 来源：个人技术集锦

Spring Boot 作为 Java 开发的 “开箱即用” 框架，以其便捷性和强大的功能广受欢迎。然而，很多开发者在使用中可能只停留在“能用”的阶段，未能挖掘出它真正的潜力。今天就带你解锁一些 Spring Boot 的实用技巧，提升开发效率，避免踩坑！

1. 善用配置文件的分环境管理

Spring Boot 提供了强大的 profile 功能，可以为不同的环境（开发、测试、生产）设置不同的配置。

怎么用？

在 application.properties 或 application.yml 中定义默认配置。

创建不同环境的配置文件，例如：

# application-dev.yml
server:
  port: 8081

# application-prod.yml
server:
  port: 8080

启动时通过 -Dspring.profiles.active 指定激活的环境：
```
java -jar app.jar --spring.profiles.active=prod
```

进阶技巧

默认激活某个环境：
```
spring.profiles.active=dev
```
合并配置：application.yml 的公共部分可与环境配置文件自动合并，减少重复配置。

2. 全局异常处理：优雅地拦截错误

不要再让异常直接暴露在前端！通过 Spring Boot 的 @ControllerAdvice 和 @ExceptionHandler，可以轻松实现全局异常处理。

示例代码

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<String> handleIllegalArgument(IllegalArgumentException e) {
        return ResponseEntity.badRequest().body("参数错误：" + e.getMessage());
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("服务器异常，请稍后再试！");
    }
}

这样，不管是参数校验还是系统错误，都能被友好地捕获和返回。

3. 数据库操作的强助手：Spring Data JPA

自定义查询方法

只需命名好方法名，Spring Data JPA 就能帮你自动生成查询逻辑：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    List<User> findByUsernameAndStatus(String username, Integer status);
}

动态查询

使用 @Query 注解，写灵活的 JPQL 或 SQL：

@Query("SELECT u FROM User u WHERE u.email = ?1")
Optional<User> findByEmail(String email);

4. Spring Boot Actuator：轻松监控应用健康状况

Spring Boot Actuator 提供了丰富的监控和管理功能，例如健康检查、指标、日志级别动态调整等。

开启 Actuator

在 application.properties 中配置：

management.endpoints.web.exposure.include=*

常用端点

/actuator/health：检查应用健康状况。
/actuator/metrics：查看性能指标。
/actuator/env：查看当前环境变量。

安全建议

默认暴露所有端点存在安全隐患，生产环境只暴露必要接口，并通过权限控制访问。

5. 条件注解：实现灵活的 Bean 注册

场景

当某些 Bean 只在特定条件下需要加载时，可以使用 Spring 提供的条件注解，例如：

@ConditionalOnProperty
@ConditionalOnMissingBean

示例

@Configuration
public class CacheConfig {

    @Bean
    @ConditionalOnProperty(name = "cache.enabled", havingValue = "true")
    public CacheManager cacheManager() {
        return new ConcurrentMapCacheManager("myCache");
    }
}

当配置文件中 cache.enabled=true 时，才会加载 cacheManager。

6. 使用 DevTools 实现热部署

Spring Boot DevTools 是开发利器，能让你的代码修改后自动重启应用，大幅提高开发效率。

如何启用？

注意

生产环境不要引入这个依赖！
配合 IDE（如 IntelliJ IDEA）的自动构建功能，效果最佳。

7. 快速集成第三方工具

集成 Swagger UI

生成 API 文档，方便测试和分享。

引入依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

添加配置类：

@Configuration
@EnableOpenApi
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.OAS_30)
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.example"))
            .paths(PathSelectors.any())
            .build();
    }
}

启动后访问：http://localhost:8080/swagger-ui/

8. 使用 @Value 和 @ConfigurationProperties 读取配置

@Value 简单高效：

@Value("${app.name}")
private String appName;

@ConfigurationProperties 灵活强大：

定义配置类：

@ConfigurationProperties(prefix = "app")
public class AppConfig {
    private String name;
    private String version;
    // getters and setters
}

在主类或配置类中启用：

@EnableConfigurationProperties(AppConfig.class)

配置文件中使用：
```
app.name=SpringBootApp
app.version=1.0
```

9. 高效日志管理

使用 application.yml 配置日志级别：

logging:
  level:
    root: INFO
    com.example: DEBUG

动态调整日志级别：

curl -X POST "http://localhost:8080/actuator/loggers/com.example" \
     -H "Content-Type: application/json" \
     -d '{"configuredLevel": "WARN"}'

总结

Spring Boot 的强大功能远不止这些，合理使用这些技巧，不仅能让开发效率大幅提升，还能避免许多潜在的坑点。希望这篇文章能帮助你在 Spring Boot 开发的道路上越走越顺！

如果你还有其他 Spring Boot 技巧或疑问，欢迎留言交流！ ?

全部栏目