1. Tình huống lỗi thực tế

Trong quá trình xây dựng hệ thống phân quyền, nhiều lập trình viên gặp phải vấn đề annotation tùy chỉnh không hoạt động như mong đợi. Cụ thể, một annotation kiểm tra truy cập @SecureAccess được định nghĩa để bảo vệ các method quan trọng, nhưng lại bị bỏ qua trong một số trường hợp gọi method đặc biệt.

// Định nghĩa annotation kiểm tra bảo mật
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface SecureAccess {
    String level();
}

// Lớp Aspect xử lý logic cắt ngang
@Aspect
@Component
public class AccessControlAspect {
    @Around("@annotation(secureAccess)")
    public Object interceptAccess(ProceedingJoinPoint joinPoint, SecureAccess secureAccess) throws Throwable {
        String requiredLevel = secureAccess.level();
        // Giả lập logic kiểm tra quyền
        if (!SecurityHolder.verifyLevel(requiredLevel)) {
            throw new RuntimeException("Từ chối truy cập");
        }
        return joinPoint.proceed();
    }
}

// Scenario gặp lỗi: Gọi trực tiếp từ class không được Spring quản lý
public class InvoiceService {
    public void processInvoice() {
        // Khởi tạo trực tiếp bằng từ khóa new, không qua Spring Container
        QualityAssurance qa = new QualityAssurance();
        qa.verifyQuality(); // AOP không được kích hoạt tại đây
    }
}

// Class chứa annotation nhưng bị gọi sai cách
@Component
public class QualityAssurance {
    @SecureAccess(level = "admin")
    public void verifyQuality() {
        // Logic nghiệp vụ kiểm tra chất lượng
    }
}

Biểu hiện lỗi:

• Khi gọi qualityAssurance.verifyQuality() từ bên ngoài qua Spring Bean, kiểm tra bảo mật hoạt động bình thường.
• Khi gọi thông qua InvoiceService.processInvoice() với khởi tạo trực tiếp, logic kiểm tra bị bỏ qua hoàn toàn.

2. Phân tích nguyên nhân sâu xa

2.1. Quy tắc sinh đối tượng Proxy

Điều kiện tiên quyết để AOP hoạt động là đối tượng gọi method phải là một Bean do Spring Container quản lý. Trong ví dụ trên, việc sử dụng từ khóa new tạo ra một đối tượng nguyên bản (target object) chứ không phải đối tượng proxy đã được weaving thêm logic aspect.

2.2. Hiện tượng tự gọi method trong cùng class

@Component
public class PaymentService {
    @Autowired
    private QualityAssurance qa; // Gọi qua Bean注入 sẽ hoạt động

    public void executePayment() {
        qa.verifyQuality(); // AOP hoạt động
    }

    // Gọi nội bộ sẽ thất bại
    public void selfInvoke() {
        verifyQuality(); // Bỏ qua proxy layer
    }

    @SecureAccess(level = "user")
    public void verifyQuality() { /* ... */ }
}

Khi một method trong class gọi một method khác cũng thuộc chính class đó, lời gọi này thực hiện trên đối tượng this. Vì this trỏ đến đối tượng gốc chứ không phải proxy, nên container không thể chặn lại để thực hiện advice.

2.3. Giới hạn với method static và access modifier

• Static method: Spring AOP dựa trên proxy instance, không thể proxy các method thuộc về class.
• Non-public method: JDK Dynamic Proxy chỉ hỗ trợ public method. CGLIB có thể hỗ trợ protected/default nhưng cần cấu hình đặc biệt.

3. Các giải pháp khắc phục

3.1. Đảm bảo đối tượng được Spring quản lý

Thay vì khởi tạo thủ công, hãy sử dụng cơ chế Dependency Injection để đảm bảo đối tượng được wrap bởi proxy.

@Component
public class InvoiceService {
    @Autowired  // Inject Bean đã được proxy
    private QualityAssurance qa;

    public void processInvoice() {
        qa.verifyQuality(); // Kích hoạt AOP thành công
    }
}

3.2. Xử lý lời gọi nội bộ bằng AopContext

Để gọi method có annotation ngay trong cùng class, cần lấy đối tượng proxy hiện hành thông qua AopContext.

// Cấu hình trong Application
@EnableAspectJAutoProxy(exposeProxy = true)

// Trong class nghiệp vụ
((PaymentService) AopContext.currentProxy()).verifyQuality();

3.3. Chuyển đổi utility class sang Bean

Nếu cần áp dụng AOP cho các hàm tiện ích, không nên để chúng là static. Hãy chuyển thành instance method và đăng ký dưới dạng Spring Bean.

3.4. Ép buộc sử dụng CGLIB Proxy

Đối với các class không implement interface, cần cấu hình rõ ràng để Spring sử dụng CGLIB thay vì JDK Dynamic Proxy.

@Configuration
@EnableAspectJAutoProxy(proxyTargetClass = true) // Force CGLIB
public class AppConfig { }

4. Nguyên tắc vận hành Spring AOP

1. Quản lý vòng đời Bean: Tuyệt đối không dùng new cho các class cần cắt ngang logic.
2. Kiểm tra lời gọi nội bộ: Sử dụng AopContext.currentProxy() khi cần self-invocation.
3. Lựa chọn cơ chế Proxy:
   • Không có interface: Bắt bật proxyTargetClass = true.
   • Có interface: Ưu tiên JDK Dynamic Proxy để giảm overhead.
4. Phạm vi truy cập:
   • Tránh dùng final cho class/method cần proxy.
   • Method private không thể bị chặn bởi AOP.
5. Giám sát hiệu năng: Tích hợp metric để đo lường thời gian thực thi của các advice.
6. Kiểm thử tích hợp: Sử dụng @SpringBootTest để xác thực proxy được tạo đúng trong ngữ cảnh container.