Testing your auto-configuration against a missing optional dependency

Bối cảnh: Khi viết auto‑configuration trong Spring Boot, các phụ thuộc tùy chọn thường được bảo vệ bằng @ConditionalOnClass để tránh lỗi khi không có thư viện đó. Nguyên nhân kỹ thuật: JVM vẫn phân tích và giải quyết signature của mọi phương thức trong lớp khi phản chiếu, vì vậy ngay cả khi @ConditionalOnClass ngăn không cho lớp được sử dụng, việc tham chiếu tới một lớp không tồn tại trong signature của một phương thức vẫn gây NoClassDefFoundError. Hệ quả: Các bộ kiểm tra thông dụng như FilteredClassLoader không thể tái hiện lỗi vì chúng không định nghĩa lớp nào; chỉ ClassLoader thực của ứng dụng mới định nghĩa auto‑configuration và tiết lộ lỗi khi người dùng thiếu phụ thuộc tùy chọn. Điểm học: Tác giả giới thiệu HidingClassLoader – một ClassLoader tùy chỉnh mà trở thành lớp định nghĩa cho các lớp đang kiểm tra đồng thời ẩn các lớp phụ thuộc, từ đó tái hiện chính xác tình huống thiếu thư viện. Giải pháp: Di chuyển các bean tham chiếu tới phụ trợ tùy chọn vào một lớp cấu hình lồng nhau cũng được bảo vệ bởi @ConditionalOnClass, mô hình mà Spring Boot zelf sử dụng internally để đảm bảo lớp chỉ được định nghĩa khi phụ trợ thực sự có mặt.