RuoYi-Vue-Pro 数据权限并发问题分析与解决方案

问题背景

在 RuoYi-Vue-Pro 项目的 master-jdk17 版本中，用户报告了一个严重的数据权限问题：在多线程并发场景下，系统会出现数据权限失效的情况，导致用户能够看到不属于自己的数据。该问题主要出现在使用数据权限注解的接口中，特别是在高并发请求时表现尤为明显。

问题现象

当系统配置了数据权限（如"可查看本部门及以下"的权限）后，通过 JMeter 等工具进行并发测试时，会出现以下异常现象：

1. 权限过滤条件失效，用户能看到超出权限范围的数据
2. 在 DataPermissionContextHolder 类中，remove 方法会抛出无法移除数据的异常（栈内数据为空）
3. 问题在重启后暂时消失，但会随着并发请求再次出现

技术分析

根本原因

问题的根源在于 DataPermissionContextHolder 类中使用了 TransmittableThreadLocal 来存储数据权限上下文：

private static final ThreadLocal<LinkedList<DataPermission>> DATA_PERMISSIONS = 
    TransmittableThreadLocal.withInitial(LinkedList::new);

TransmittableThreadLocal 是阿里开源的一个线程本地变量解决方案，主要用于解决线程池场景下的线程本地变量传递问题。然而在这种特定场景下，它反而导致了以下问题：

1. 线程安全问题：在多线程并发环境下，TransmittableThreadLocal 的变量传递机制可能导致权限上下文被错误地共享或覆盖
2. 栈管理异常：LinkedList 作为栈结构使用时，在并发场景下容易出现空栈异常
3. 上下文污染：线程复用时，可能导致上一个请求的权限上下文污染当前请求

解决方案验证

测试发现，将 TransmittableThreadLocal 替换为普通的 ThreadLocal 后，问题得到解决：

private static final ThreadLocal<LinkedList<DataPermission>> DATA_PERMISSIONS = 
    new ThreadLocal<>();

项目维护者的修复

项目维护者在后续版本中已经修复了这个问题。根据维护者的回复，该问题在 2.3.0 版本中得到了彻底解决。对于仍在使用 2.1.0-snapshot 版本的用户，建议升级到 2.3.0 版本以获得稳定的数据权限功能。

最佳实践建议

1. 版本升级：建议所有用户升级到 2.3.0 或更高版本，以获得最稳定的数据权限功能
2. 并发测试：在开发过程中，应对数据权限接口进行充分的并发测试
3. 权限监控：实现权限过滤的日志记录，便于及时发现和排查权限异常
4. 线程隔离：在自定义业务逻辑中，确保权限上下文的正确初始化和清理

总结

数据权限是企业管理系统中至关重要的安全特性。RuoYi-Vue-Pro 项目通过不断迭代优化，已经解决了早期版本中存在的并发权限问题。开发者在使用时应当注意版本选择，并遵循项目的最佳实践指南，以确保系统数据安全性的万无一失。