SpringBoot中如何使用Assert进行断言校验

 更新时间:2025年07月09日 15:41:13   作者:超级小忍  
Java 提供了内置的 assert 机制,而 Spring 框架也提供了更强大的 Assert 工具类来帮助开发者进行参数校验和状态检查,下面我们就来看看SpringBoot中如何使用Assert进行断言校验吧

前言

在开发 Spring Boot 应用时,确保程序逻辑的正确性和数据的有效性是非常重要的。Java 提供了内置的 assert 机制,而 Spring 框架也提供了更强大的 Assert 工具类来帮助开发者进行参数校验和状态检查。

本文将详细介绍:

  • Java 原生 assert 的使用;
  • Spring 提供的 Assert 类;
  • 如何在 Spring Boot 中合理使用断言;
  • 实际应用场景与示例;
  • 最佳实践建议。

一、Java 原生assert简介

Java 自 J2SE 1.4 开始引入了 assert 关键字,用于在运行时对某些条件进行验证。如果断言失败(即条件为 false),则会抛出 AssertionError

1.1 使用方式

assert condition;
assert condition : errorMessage;

1.2 示例代码

public class AssertExample {
    public static void main(String[] args) {
        int age = -5;
        assert age >= 0 : "年龄不能为负数: " + age;
        System.out.println("年龄是:" + age);
    }
}

注意:默认情况下 JVM 是禁用断言的,需要加上 -ea(enable assertions)参数启动:

java -ea AssertExample

1.3 优缺点分析

优点缺点
简单易用默认不启用
可快速发现逻辑错误不适合用于生产环境
适合调试阶段使用抛出的是 Error,不是 Exception

二、Spring Framework 中的Assert工具类

Spring 提供了 org.springframework.util.Assert 工具类,封装了一系列静态方法,专门用于参数校验和状态断言。

2.1 引入依赖

如果你使用的是 Spring Boot,默认已经包含了 Spring Core 模块,因此可以直接使用 Assert 类。

Maven 项目中可以确认是否包含以下依赖(通常不需要手动添加):

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
</dependency>

2.2 常用方法介绍

方法名描述
Assert.notNull(Object object, String message)判断对象是否为 null,否则抛出 IllegalArgumentException
Assert.hasText(String text, String message)判断字符串是否非空且非空白
Assert.isTrue(boolean expression, String message)判断布尔表达式是否为 true
Assert.noNullElements(Collection<?> collection, String message)集合中不能有 null 元素
Assert.state(boolean expression, String message)用于检查对象状态,抛出 IllegalStateException

2.3 示例代码

示例 1:检查参数非空

import org.springframework.util.Assert;

public class UserService {
    public void createUser(String username) {
        Assert.notNull(username, "用户名不能为空");
        // 创建用户逻辑
    }
}

示例 2:检查集合元素非空

import java.util.List;
import org.springframework.util.Assert;

public class OrderService {
    public void processOrders(List<String> orderIds) {
        Assert.notEmpty(orderIds, "订单ID列表不能为空");
        Assert.noNullElements(orderIds, "订单ID中不能包含null值");
        // 处理订单逻辑
    }
}

示例 3:检查状态

public class PaymentService {
    private boolean initialized = false;

    public void init() {
        // 初始化逻辑
        initialized = true;
    }

    public void pay() {
        Assert.state(initialized, "支付服务未初始化");
        // 支付逻辑
    }
}

三、在 Spring Boot 中的最佳使用场景

3.1 Controller 层参数校验

虽然 @Valid@RequestBody 注解更适合做请求参数校验,但在业务逻辑处理前也可以使用 Assert 来进一步确保参数有效。

@RestController
@RequestMapping("/users")
public class UserController {

    @PostMapping
    public ResponseEntity<Void> createUser(@RequestBody UserDto userDto) {
        Assert.notNull(userDto, "用户信息不能为空");
        Assert.hasText(userDto.getUsername(), "用户名不能为空");

        // 调用 service 保存用户
        return ResponseEntity.ok().build();
    }
}

3.2 Service 层参数或状态校验

这是最推荐使用 Assert 的地方,可以避免非法参数传递到核心业务逻辑中。

@Service
public class OrderService {

    public void placeOrder(Order order) {
        Assert.notNull(order, "订单不能为空");
        Assert.notNull(order.getItems(), "订单商品列表不能为空");

        if (order.getItems().isEmpty()) {
            throw new IllegalArgumentException("订单必须包含至少一个商品");
        }

        // 下单逻辑
    }
}

3.3 Repository 层数据一致性校验(可选)

对于数据库操作之前的数据一致性检查,也可以加入断言辅助判断。

@Repository
public class UserRepository {

    public void save(User user) {
        Assert.notNull(user, "用户实体不能为空");
        Assert.hasText(user.getEmail(), "邮箱不能为空");

        // 执行保存操作
    }
}

四、与 Bean Validation 的对比

特性Assert@Valid / JSR 380
校验时机方法调用前接收到请求后自动校验
抛出异常类型IllegalArgumentException, IllegalStateExceptionMethodArgumentNotValidException
是否支持嵌套对象校验否,需手动编写逻辑
是否适用于所有层主要用于 Controller 层
是否支持国际化
是否可组合多个规则是(通过注解组合)

结论

  • @Valid 更适合前端传参的统一校验;
  • Assert 更适合在 Service、Repository 或内部逻辑中进行细粒度的参数或状态检查。

五、最佳实践建议

  • 不要替代正式异常处理:断言用于“不应该发生”的情况,而不是预期中的错误。
  • 避免在公有 API 中使用 assert:因为原生 assert 可能被关闭,行为不可控。
  • 优先使用 Spring 的 Assert 类:它抛出的是 IllegalArgumentExceptionIllegalStateException,易于捕获和处理。
  • 结合日志记录:在断言失败时记录详细信息,有助于排查问题。
  • 断言信息要清晰明确:便于定位问题,如 "用户名不能为空""invalid input" 更好。

六、总结

在 Spring Boot 项目中,assertAssert 类是两个非常实用的工具,可以帮助我们在开发过程中尽早发现问题,提升代码健壮性。尽管它们不具备完整的校验能力,但作为轻量级的防御性编程手段,非常适合用于中间层的参数和状态检查。

使用位置推荐方式
Controller@Valid + @RequestBody + Assert 辅助
ServiceAssert 校验参数/状态
RepositoryAssert 校验输入数据合法性

掌握并合理使用这些断言机制,不仅能提高代码质量,也能减少运行时错误的发生。

到此这篇关于SpringBoot中如何使用Assert进行断言校验的文章就介绍到这了,更多相关SpringBoot断言校验内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 深入分析JAVA Synchronized关键字

    深入分析JAVA Synchronized关键字

    这篇文章主要介绍了析JAVA Synchronized关键字的相关知识,文中代码非常详细,帮助大家更好的理解和学习,感兴趣的朋友可以了解下
    2020-06-06
  • java中isEmpty和isBlank的区别小结

    java中isEmpty和isBlank的区别小结

    Java中的isEmpty和isBlank都是用来判断字符串是否为空的方法,但在不同的情况下有所区别,具有一定的参考价值,感兴趣的可以了解一下
    2023-09-09
  • JVM的垃圾回收机制真是通俗易懂

    JVM的垃圾回收机制真是通俗易懂

    这篇文章主要为大家详细介绍了JVM的垃圾回收机制,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-02-02
  • JAVA调用JavaScript方法代码示例

    JAVA调用JavaScript方法代码示例

    之前在一次机缘巧合的情况下,需要时用JAVA执行js方法,查阅了一些文档,找到了相关解决方法,这里和大家分享一下,这篇文章主要给大家介绍了关于JAVA调用JavaScript方法的相关资料,需要的朋友可以参考下
    2023-09-09
  • Mybatis中#{}与${}的区别详解

    Mybatis中#{}与${}的区别详解

    这篇文章主要介绍了Mybatis中#{}与${}的区别详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-12-12
  • Java静态和非静态成员变量初始化过程解析

    Java静态和非静态成员变量初始化过程解析

    这篇文章主要介绍了Java静态和非静态成员变量初始化过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-01-01
  • 关于@Autowired注解和静态方法及new的关系

    关于@Autowired注解和静态方法及new的关系

    这篇文章主要介绍了关于@Autowired注解和静态方法及new的关系,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-02-02
  • 关于Maven的使用,这些你都真的了解么

    关于Maven的使用,这些你都真的了解么

    这篇文章主要介绍了关于Maven的使用,这些你都真的了解么?具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-06-06
  • SpringBoot的API文档生成工具SpringDoc使用详解

    SpringBoot的API文档生成工具SpringDoc使用详解

    这篇文章主要为大家介绍了SpringBoot的API文档生成工具SpringDoc使用详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-06-06
  • 教你在SpringBoot中管理多环境配置文件

    教你在SpringBoot中管理多环境配置文件

    在项目开发中,一般会分为开发环境,测试环境和生产环境.如果总是在一个文件中修修改改,难免会出现错误,尤其是在交接的过程中,一旦出现问题,轻则丢失绩效,重则需要删库跑路.本文则带大家详细了解怎么管理多环境配置文件,需要的朋友可以参考下
    2021-05-05

最新评论