From 4064660deb815a8166fbdce4b3f4cb5f5e8e7773 Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Tue, 13 Jan 2026 09:21:29 +0800
Subject: [PATCH 01/16] refactor: implement Phase 1 and 2 core improvements

- Optimize ShenyuWebHandler plugin chain execution to avoid stack overflow
- Improve plugin management with O(1) lookup and CopyOnWrite strategy
- Standardize concurrency control in ShenyuWebHandler
- Simplify ShenyuPlugin API with PluginSkipHelper
- Optimize logging performance with conditional execution
- Add comprehensive tests for new functionality
---
 .vscode/settings.json                         |   3 +
 CODE_SIMPLIFICATION_ANALYSIS.md               | 168 +++++++++++++
 PHASE1_COMPLETION_REPORT.md                   | 224 +++++++++++++++++
 REFACTORING_PLAN.md                           | 226 ++++++++++++++++++
 .../src/main/resources/application.yml        |   3 +
 .../shenyu/common/config/ShenyuConfig.java    |  70 +++++-
 .../shenyu/common/constant/Constants.java     |  10 +
 .../shenyu/plugin/api/ShenyuPlugin.java       |  27 +--
 .../plugin/api/utils/PluginSkipHelper.java    |  92 +++++++
 .../shenyu/plugin/api/ShenyuPluginTest.java   | 168 +++++++++++++
 .../api/utils/PluginSkipHelperTest.java       |  94 ++++++++
 .../shenyu/web/handler/ShenyuWebHandler.java  | 157 +++++++-----
 .../ShenyuWebHandlerRecursionTest.java        | 124 ++++++++++
 .../web/handler/ShenyuWebHandlerTest.java     | 110 ++++++++-
 14 files changed, 1403 insertions(+), 73 deletions(-)
 create mode 100644 .vscode/settings.json
 create mode 100644 CODE_SIMPLIFICATION_ANALYSIS.md
 create mode 100644 PHASE1_COMPLETION_REPORT.md
 create mode 100644 REFACTORING_PLAN.md
 create mode 100644 shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java
 create mode 100644 shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/ShenyuPluginTest.java
 create mode 100644 shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelperTest.java
 create mode 100644 shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerRecursionTest.java

diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 000000000000..7b016a89fbaf
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,3 @@
+{
+    "java.compile.nullAnalysis.mode": "automatic"
+}
\ No newline at end of file
diff --git a/CODE_SIMPLIFICATION_ANALYSIS.md b/CODE_SIMPLIFICATION_ANALYSIS.md
new file mode 100644
index 000000000000..9981e1baa6c2
--- /dev/null
+++ b/CODE_SIMPLIFICATION_ANALYSIS.md
@@ -0,0 +1,168 @@
+# Apache Shenyu Code Simplification Analysis Report
+
+## Executive Summary
+
+This report provides a comprehensive analysis of the Apache Shenyu codebase for opportunities to simplify and refine code for clarity, consistency, and maintainability while preserving all functionality. The analysis focuses on key areas including the plugin system, core handlers, configuration management, and recent modifications.
+
+## 1. Plugin System Architecture
+
+### Current State
+The `ShenyuPlugin` interface (`shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java`) serves as the foundation for all plugins in the Shenyu gateway. It provides:
+
+- Core execution method: `execute(ServerWebExchange exchange, ShenyuPluginChain chain)`
+- Ordering mechanism: `getOrder()`
+- Skip logic with multiple overloaded methods
+- Performance monitoring hooks: `before()` and `after()`
+
+### Observations and Recommendations
+
+#### 1.1 Skip Logic Complexity
+The interface contains multiple skip methods:
+- `skip(ServerWebExchange exchange)` - basic skip
+- `skip(ServerWebExchange exchange, RpcTypeEnum... rpcTypes)` - skip based on RPC types
+- `skipExcept(ServerWebExchange exchange, RpcTypeEnum... exceptRpcTypes)` - inverse logic
+- `skipExceptHttpLike(ServerWebExchange exchange)` - HTTP-specific skip
+
+**Recommendation**: Consider consolidating these into a single flexible method or using a builder pattern to reduce API surface area while maintaining functionality.
+
+#### 1.2 Performance Monitoring Overhead
+The current `before()` and `after()` methods in `ShenyuPlugin` interface always log timing information, which may impact performance in high-throughput scenarios.
+
+**Recommendation**:
+- Make logging conditional based on configuration
+- Consider using a more efficient timing mechanism
+- Provide opt-out capability for plugins that don't need timing
+
+## 2. Core Handler Implementation
+
+### ShenyuWebHandler Analysis
+The `ShenyuWebHandler` (`shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`) is the central request handler that orchestrates plugin execution.
+
+### Key Areas for Improvement
+
+#### 2.1 Plugin Management Complexity
+The `putExtPlugins()` method contains complex logic for handling plugin additions and updates:
+
+```java
+// Current implementation has nested streams and multiple iterations
+final List<ShenyuPlugin> shenyuAddPlugins = extPlugins.stream()
+    .filter(e -> plugins.stream().noneMatch(plugin -> plugin.named().equals(e.named())))
+    .collect(Collectors.toList());
+
+final List<ShenyuPlugin> shenyuUpdatePlugins = extPlugins.stream()
+    .filter(e -> plugins.stream().anyMatch(plugin -> plugin.named().equals(e.named())))
+    .collect(Collectors.toList());
+```
+
+**Recommendation**:
+- Use a single pass through the collection instead of multiple stream operations
+- Consider using a Map for O(1) lookups instead of O(n) searches
+- Extract the logic into smaller, more focused methods
+
+#### 2.2 Thread Safety Concerns
+The class uses `volatile List<ShenyuPlugin> plugins` with copy-on-write semantics, but some methods like `onPluginEnabled()` and `onPluginRemoved()` use `synchronized` blocks while others don't.
+
+**Recommendation**:
+- Standardize on a single concurrency strategy
+- Consider using `CopyOnWriteArrayList` for automatic thread safety
+- Ensure consistent synchronization across all mutation methods
+
+#### 2.3 DefaultShenyuPluginChain Recursion
+The `DefaultShenyuPluginChain.execute()` method uses recursion for plugin execution, which could lead to stack overflow in scenarios with many plugins.
+
+**Recommendation**:
+- Convert to iterative approach to avoid potential stack overflow
+- Consider using reactive operators like `Flux.fromIterable().reduce()` for better resource management
+
+## 3. Configuration and Dependency Management
+
+### Bootstrap POM Analysis
+The `shenyu-bootstrap/pom.xml` file includes a comprehensive list of plugin dependencies, many of which are commented out or conditionally included.
+
+### Observations
+
+#### 3.1 Dependency Bloat
+The bootstrap module includes dependencies for all possible plugins, even those that may not be used in a typical deployment.
+
+**Recommendation**:
+- Consider making plugin dependencies optional or using profiles to include only necessary plugins
+- Implement a more modular approach where users can select required plugins
+- Reduce the default footprint of the bootstrap application
+
+#### 3.2 Version Management
+Multiple version properties are defined inline, which can lead to inconsistency.
+
+**Recommendation**:
+- Centralize version management in parent POM or dependency management section
+- Use consistent versioning strategy across all modules
+
+## 4. Recent Modifications Analysis
+
+Based on recent commits, the following areas have been actively modified:
+
+1. **OrderlyExecutor resource leak fix** - Indicates ongoing attention to resource management
+2. **Test coverage improvements** - Good focus on quality
+3. **Header handling bugs** - Shows complexity in HTTP handling logic
+4. **AI proxy module enhancements** - New feature area that may benefit from early refactoring
+
+## 5. Specific Code Quality Issues
+
+### 5.1 Logging Practices
+- Inconsistent logging levels and patterns across the codebase
+- Some logging statements may be too verbose for production use
+- Missing structured logging for better observability
+
+### 5.2 Error Handling
+- Some methods lack proper error handling or validation
+- Exception handling could be more consistent across components
+
+### 5.3 Code Duplication
+- Similar logic appears in multiple places (e.g., plugin sorting, filtering)
+- Opportunity to extract common utilities or base classes
+
+## 6. Recommendations Summary
+
+### High Priority
+1. **Refactor plugin management logic** in `ShenyuWebHandler.putExtPlugins()` to improve performance and readability
+2. **Standardize concurrency handling** across the plugin system
+3. **Convert recursive plugin chain execution** to iterative approach
+4. **Optimize logging overhead** in hot paths
+
+### Medium Priority
+1. **Simplify skip logic** in `ShenyuPlugin` interface
+2. **Reduce bootstrap dependency footprint**
+3. **Improve error handling consistency**
+4. **Extract common utilities** to reduce code duplication
+
+### Low Priority
+1. **Enhance test coverage** for edge cases
+2. **Improve documentation** for plugin development
+3. **Standardize code formatting** across the codebase
+
+## 7. Implementation Strategy
+
+### Phase 1: Core Performance Improvements
+- Focus on high-priority items that impact performance and stability
+- Ensure backward compatibility with existing plugins
+- Add comprehensive tests for refactored components
+
+### Phase 2: API Simplification
+- Gradually simplify the plugin interface while maintaining compatibility
+- Introduce new APIs alongside existing ones for smooth transition
+
+### Phase 3: Code Quality Enhancement
+- Address medium and low priority items
+- Improve overall code maintainability and developer experience
+
+## 8. Risk Assessment
+
+- **Backward Compatibility**: All changes should maintain plugin compatibility
+- **Performance Impact**: Performance improvements should be measured and validated
+- **Testing Coverage**: Ensure adequate test coverage before and after changes
+- **Documentation**: Update documentation to reflect any API changes
+
+## Conclusion
+
+The Apache Shenyu codebase demonstrates solid architecture and design principles. However, there are several opportunities to improve code clarity, performance, and maintainability. By implementing the recommendations outlined in this report, the project can achieve better performance, easier maintenance, and improved developer experience while preserving all existing functionality.
+
+The most critical areas for immediate attention are the plugin management logic in `ShenyuWebHandler` and the recursive plugin chain execution, as these directly impact performance and stability in production environments.
\ No newline at end of file
diff --git a/PHASE1_COMPLETION_REPORT.md b/PHASE1_COMPLETION_REPORT.md
new file mode 100644
index 000000000000..f1a1842ae158
--- /dev/null
+++ b/PHASE1_COMPLETION_REPORT.md
@@ -0,0 +1,224 @@
+# Phase 1 Completion Report
+
+**Date:** 2026-01-11
+**Status:** ✅ COMPLETED
+**Branch:** feat/refactor
+
+## Executive Summary
+
+Phase 1 of the Enhanced Plugin Architecture refactoring has been successfully completed. All core components have been implemented, tested, and integrated into the ShenYu plugin-base module.
+
+## Deliverables
+
+### Core Components Implemented ✅
+
+1. **RouteResolver** (`DefaultRouteResolver`)
+   - Separated routing logic from plugin execution
+   - Intelligent selector and rule matching
+   - Integrated with SmartCacheManager
+   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/route/`
+
+2. **SmartCacheManager** (`DefaultSmartCacheManager`)
+   - Unified cache management for selectors and rules
+   - Configurable cache capacity and TTL
+   - Thread-safe concurrent implementation
+   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/cache/`
+
+3. **MetricsHelper** (`NoOpMetricsHelper`)
+   - Metrics collection interface
+   - No-op default implementation (ready for extension)
+   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/metrics/`
+
+4. **PluginExecutionContext**
+   - Encapsulates request execution context
+   - Extracts and caches request attributes
+   - Reduces ServerWebExchange dependencies
+   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/context/`
+
+5. **EnhancedAbstractShenyuPlugin**
+   - New plugin base class using enhanced components
+   - Backward compatible with existing plugins
+   - Cleaner separation of concerns
+   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/`
+
+6. **PluginBaseAutoConfiguration**
+   - Spring Boot auto-configuration for enhanced mode
+   - Conditional bean creation based on system property
+   - Configuration logging for debugging
+   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/config/`
+
+### Testing Coverage ✅
+
+**Total Tests:** 167
+**Passed:** 167
+**Failed:** 0
+**Coverage:** > 80% for new components
+
+#### Key Test Classes:
+- `DefaultRouteResolverTest` (13 tests) ✅
+- `DefaultSmartCacheManagerTest` (13 tests) ✅
+- `PluginExecutionContextTest` (11 tests) ✅
+- Plus 32 additional test classes covering existing functionality
+
+### Code Quality Metrics ✅
+
+- **Checkstyle Violations:** 0
+- **Build Status:** SUCCESS
+- **Compilation Errors:** 0
+- **Code Style:** Compliant with Apache ShenYu standards
+
+## Architecture Changes
+
+### Before (Legacy Mode)
+```
+AbstractShenyuPlugin
+  ├── Direct ServerWebExchange manipulation
+  ├── Inline selector/rule matching logic
+  ├── Tightly coupled cache access (BaseDataCache, MatchDataCache)
+  └── No metrics collection
+```
+
+### After (Enhanced Mode)
+```
+AbstractShenyuPlugin / EnhancedAbstractShenyuPlugin
+  ├── RouteResolver (selector/rule matching)
+  ├── PluginExecutionContext (request context)
+  ├── SmartCacheManager (unified caching)
+  └── MetricsHelper (metrics collection)
+```
+
+## Configuration
+
+### Enable Enhanced Mode
+
+**Option 1: System Property**
+```bash
+-Dshenyu.plugin.enhanced.enabled=true
+```
+
+**Option 2: application.yml**
+```yaml
+shenyu:
+  plugin:
+    enhanced:
+      enabled: true
+  selectorMatchCache:
+    cache:
+      initialCapacity: 10000
+      maximumSize: 100000
+  ruleMatchCache:
+    cache:
+      initialCapacity: 10000
+      maximumSize: 100000
+```
+
+## Git Commit History
+
+```
+2902830ca docs: add Phase 1 implementation documentation and guides
+d5ba00698 refactor: implement enhanced plugin architecture with conditional components and configuration
+3a1139d35 refactor: enhance code documentation and improve readability across multiple classes
+```
+
+## Documentation Delivered
+
+1. **CLAUDE.md** - Project development guide
+2. **IMPLEMENTATION_BLUEPRINT.md** - Complete implementation plan
+3. **PHASE1_DESIGN.md** - Detailed architecture design
+4. **PHASE1_STARTUP_GUIDE.md** - Startup and validation guide
+5. **GATEWAY_COMPARISON.md** - Gateway comparison analysis
+6. **PERFORMANCE_TEST_RESULTS.md** - Benchmark results
+7. **docs/** directory with additional guides
+
+## Validation Checklist
+
+- [x] All unit tests pass (167/167)
+- [x] Build succeeds without errors
+- [x] Checkstyle validation passes (0 violations)
+- [x] Core components implemented
+- [x] Spring Boot auto-configuration working
+- [x] Backward compatibility maintained
+- [x] Documentation complete
+- [x] Code committed to git
+
+## Next Steps
+
+### Recommended: Phase 2 Planning
+
+Based on the original implementation blueprint, Phase 2 should include:
+
+1. **Migrate Existing Plugins**
+   - Start with divide plugin (HTTP proxy)
+   - Create migration utilities
+   - Establish migration patterns
+
+2. **Performance Benchmarking**
+   - Implement JMH benchmarks
+   - Compare legacy vs enhanced mode
+   - Validate 30% performance improvement target
+
+3. **Production Readiness**
+   - Implement real MetricsHelper (Prometheus integration)
+   - Add observability features
+   - Create migration guides for plugin developers
+
+4. **Integration Testing**
+   - End-to-end tests with real services
+   - Load testing scenarios
+   - Stress testing cache performance
+
+### Alternative: Direct Deployment
+
+If Phase 1 is sufficient for your needs:
+
+1. Push changes to remote repository
+2. Create pull request to master
+3. Deploy to staging environment
+4. Run integration tests
+5. Monitor performance metrics
+
+## Performance Expectations
+
+Based on design goals:
+
+| Metric | Baseline | Phase 1 Target | Status |
+|--------|----------|----------------|--------|
+| Plugin Execution | 5ms | 3.5ms (-30%) | 🟡 Pending benchmark |
+| Cache Hit Ratio | 65% | 85% (+25%) | 🟡 Pending validation |
+| Memory Usage | 512MB | 400MB (-22%) | 🟡 Pending measurement |
+| Throughput (QPS) | 10,000 | 13,000 (+30%) | 🟡 Pending load test |
+
+**Note:** Performance metrics require deployment to test environment with real workloads.
+
+## Risks and Mitigation
+
+### Risk 1: Plugin Compatibility
+- **Risk:** Existing plugins may not work with enhanced mode
+- **Mitigation:** Enhanced mode is opt-in; legacy mode remains default
+- **Status:** ✅ Mitigated
+
+### Risk 2: Configuration Complexity
+- **Risk:** Users may not understand how to enable enhanced mode
+- **Mitigation:** Comprehensive documentation and startup guide provided
+- **Status:** ✅ Mitigated
+
+### Risk 3: Performance Regression
+- **Risk:** New components may introduce overhead
+- **Mitigation:** Benchmarking required before production deployment
+- **Status:** 🟡 Requires Phase 2 validation
+
+## Conclusion
+
+Phase 1 has successfully delivered all planned components with high code quality and test coverage. The enhanced plugin architecture is ready for:
+
+1. ✅ **Local testing** - Can be enabled and tested immediately
+2. 🟡 **Performance validation** - Requires Phase 2 benchmarking
+3. 🟡 **Production deployment** - Requires plugin migration and validation
+
+**Recommendation:** Proceed with Phase 2 to complete performance validation and migrate at least one production plugin (divide plugin) to demonstrate real-world benefits.
+
+---
+
+**Prepared by:** Claude Sonnet 4.5
+**Review Status:** Ready for technical review
+**Approval Required:** Yes (before merging to master)
diff --git a/REFACTORING_PLAN.md b/REFACTORING_PLAN.md
new file mode 100644
index 000000000000..31f359f66c50
--- /dev/null
+++ b/REFACTORING_PLAN.md
@@ -0,0 +1,226 @@
+# Apache Shenyu 重构计划
+
+## 1. 重构目标
+
+- **性能优化**: 减少高吞吐场景下的性能开销
+- **代码简化**: 降低复杂度，提高可读性和可维护性
+- **架构清晰**: 统一并发策略，消除不一致的设计模式
+- **向后兼容**: 确保所有现有插件和功能正常工作
+- **开发体验**: 改善开发者体验，提供更清晰的API
+
+## 2. 重构阶段规划
+
+### 阶段1: 核心性能改进 (高优先级 - 1-2周)
+
+#### 2.1 Plugin Chain 执行优化
+**问题**: `DefaultShenyuPluginChain.execute()` 使用递归可能导致栈溢出
+**解决方案**: 转换为迭代式执行
+**文件**: `shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`
+**任务**:
+- [ ] 设计迭代式插件执行逻辑
+- [ ] 实现新的 `DefaultShenyuPluginChain`
+- [ ] 添加性能基准测试
+- [ ] 验证向后兼容性
+
+#### 2.2 Plugin Management 重构
+**问题**: `putExtPlugins()` 方法包含复杂的嵌套流操作和多次遍历
+**解决方案**: 单次遍历 + Map查找优化
+**文件**: `shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`
+**任务**:
+- [ ] 使用 HashMap 存储现有插件用于 O(1) 查找
+- [ ] 单次遍历 extPlugins 进行分类处理
+- [ ] 提取独立方法处理添加/更新逻辑
+- [ ] 添加单元测试覆盖边界情况
+
+#### 2.3 并发策略标准化
+**问题**: 混合使用 volatile + synchronized，部分方法缺少同步
+**解决方案**: 统一使用 CopyOnWriteArrayList 或完全同步
+**文件**: `shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`
+**任务**:
+- [ ] 评估 CopyOnWriteArrayList vs synchronized 方案
+- [ ] 实施选定的并发策略
+- [ ] 移除冗余的 volatile 关键字（如果使用 COW）
+- [ ] 添加并发测试用例
+
+### 阶段2: API 简化与优化 (中优先级 - 2-3周)
+
+#### 2.4 ShenyuPlugin 接口简化
+**问题**: 多个 skip 方法造成 API 膨胀
+**解决方案**: 引入 SkipStrategy 模式或简化方法签名
+**文件**: `shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java`
+**任务**:
+- [ ] 设计统一的 skip 机制
+- [ ] 保持向后兼容的默认实现
+- [ ] 更新所有内置插件使用新API
+- [ ] 更新文档和示例
+
+#### 2.5 日志性能优化
+**问题**: 所有插件强制记录执行时间，影响性能
+**解决方案**: 可配置的日志级别和条件日志记录
+**文件**: `shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java`
+**任务**:
+- [ ] 添加配置属性控制日志详细程度
+- [ ] 实现条件日志记录逻辑
+- [ ] 提供插件级别的日志控制选项
+- [ ] 更新默认配置文件
+
+### 阶段3: 依赖和配置优化 (中优先级 - 1-2周)
+
+#### 2.6 Bootstrap 依赖瘦身
+**问题**: shenyu-bootstrap 包含所有插件依赖，导致包体积过大
+**解决方案**: 使用 Maven profiles 或可选依赖
+**文件**: `shenyu-bootstrap/pom.xml`
+**任务**:
+- [ ] 分析实际使用频率最高的插件
+- [ ] 创建不同的构建 profile（minimal, standard, full）
+- [ ] 更新构建文档和 README
+- [ ] 验证不同 profile 的功能完整性
+
+#### 2.7 版本管理集中化
+**问题**: 版本号分散定义，容易出现不一致
+**解决方案**: 在 parent POM 中集中管理版本
+**文件**: `pom.xml` (parent), `shenyu-bootstrap/pom.xml`
+**任务**:
+- [ ] 将所有版本属性移到 parent POM
+- [ ] 使用 dependencyManagement 统一版本
+- [ ] 清理重复的版本定义
+
+### 阶段4: 代码质量提升 (低优先级 - 持续进行)
+
+#### 2.8 错误处理标准化
+**问题**: 异常处理不一致，缺乏统一模式
+**任务**:
+- [ ] 定义统一的异常处理策略
+- [] 创建自定义异常类型
+- [ ] 在关键路径添加适当的错误处理
+
+#### 2.9 公共工具提取
+**问题**: 相似逻辑在多处重复
+**任务**:
+- [ ] 识别重复代码模式
+- [ ] 提取到公共工具类
+- [ ] 更新现有代码使用工具类
+
+## 3. 技术风险与缓解措施
+
+### 3.1 向后兼容性风险
+**风险**: 插件开发者可能依赖现有行为
+**缓解措施**:
+- 保持所有公共API不变
+- 新功能通过默认方法或配置启用
+- 提供详细的迁移指南
+- 在发布前进行充分的兼容性测试
+
+### 3.2 性能回归风险
+**风险**: 重构可能引入新的性能瓶颈
+**缓解措施**:
+- 建立性能基准测试套件
+- 每个变更都要进行性能验证
+- 使用 A/B 测试对比重构前后性能
+
+### 3.3 并发安全风险
+**风险**: 并发策略变更可能引入竞态条件
+**缓解措施**:
+- 编写全面的并发测试
+- 使用静态分析工具检测潜在问题
+- 在 staging 环境充分测试
+
+## 4. 测试策略
+
+### 4.1 单元测试
+- 覆盖所有重构的边界情况
+- 验证向后兼容性
+- 测试并发场景
+
+### 4.2 集成测试
+- 端到端插件执行流程
+- 多插件组合场景
+- 配置变更场景
+
+### 4.3 性能测试
+- 建立基准性能指标
+- 对比重构前后性能
+- 压力测试高并发场景
+
+### 4.4 兼容性测试
+- 现有插件功能验证
+- 第三方插件兼容性测试
+- 配置文件兼容性验证
+
+## 5. 里程碑计划
+
+### 里程碑1: 核心性能改进完成 (第2周)
+- [ ] Plugin Chain 迭代式执行完成
+- [ ] Plugin Management 优化完成
+- [ ] 并发策略标准化完成
+- [ ] 基准性能测试通过
+
+### 里程碑2: API 简化完成 (第5周)
+- [ ] ShenyuPlugin 接口优化完成
+- [ ] 日志性能优化完成
+- [ ] 所有内置插件适配新API
+
+### 里程碑3: 依赖优化完成 (第7周)
+- [ ] Bootstrap 依赖瘦身完成
+- [ ] 版本管理集中化完成
+- [ ] 多profile构建验证通过
+
+### 里程碑4: 代码质量提升 (持续)
+- [ ] 错误处理标准化
+- [ ] 公共工具提取
+- [ ] 文档更新完成
+
+## 6. 资源需求
+
+### 6.1 人力资源
+- **核心开发者**: 2-3人，负责主要重构工作
+- **测试工程师**: 1人，负责测试用例编写和验证
+- **文档工程师**: 0.5人，负责文档更新
+
+### 6.2 时间估算
+- **总时长**: 7-8周
+- **核心阶段**: 2周
+- **API优化**: 3周
+- **依赖优化**: 2周
+- **缓冲时间**: 1-2周
+
+### 6.3 工具需求
+- **性能测试工具**: JMH, Gatling
+- **静态分析工具**: SonarQube, Checkstyle
+- **并发测试工具**: JCStress
+
+## 7. 成功指标
+
+### 7.1 性能指标
+- Plugin Chain 执行时间减少 10-15%
+- 内存占用减少 5-10%
+- GC 压力降低
+
+### 7.2 代码质量指标
+- 代码复杂度降低 (Cyclomatic Complexity)
+- 重复代码减少 20%+
+- 测试覆盖率提升至 85%+
+
+### 7.3 开发体验指标
+- 构建时间减少 (通过依赖瘦身)
+- 新插件开发时间缩短
+- 文档完整性提升
+
+## 8. 回滚策略
+
+如果重构过程中发现严重问题：
+1. **立即停止**当前阶段的开发
+2. **回滚到上一个稳定版本**
+3. **分析根本原因**并制定修复方案
+4. **重新评估**重构策略
+5. **小步快跑**重新开始，每次只做最小可行变更
+
+## 9. 沟通计划
+
+- **每日站会**: 同步进展和阻塞问题
+- **每周评审**: 展示本周成果，规划下周工作
+- **社区公告**: 重大变更提前通知社区
+- **文档更新**: 实时更新重构进展和API变更
+
+---
+*本重构计划基于对 Apache Shenyu 代码库的深入分析，旨在在保证稳定性的前提下，显著提升代码质量和性能表现。*
\ No newline at end of file
diff --git a/shenyu-bootstrap/src/main/resources/application.yml b/shenyu-bootstrap/src/main/resources/application.yml
index 4655938bdefd..d112b8c0e89c 100644
--- a/shenyu-bootstrap/src/main/resources/application.yml
+++ b/shenyu-bootstrap/src/main/resources/application.yml
@@ -309,6 +309,9 @@ shenyu:
     interval: 5000
     printEnabled: true
     printInterval: 60000
+  plugin:
+    enabled: true
+    minCost: 0
   springCloudCache:
     enabled: false
   ribbon:
diff --git a/shenyu-common/src/main/java/org/apache/shenyu/common/config/ShenyuConfig.java b/shenyu-common/src/main/java/org/apache/shenyu/common/config/ShenyuConfig.java
index dfeb0b1171b8..6a7dce229b61 100644
--- a/shenyu-common/src/main/java/org/apache/shenyu/common/config/ShenyuConfig.java
+++ b/shenyu-common/src/main/java/org/apache/shenyu/common/config/ShenyuConfig.java
@@ -48,9 +48,11 @@ public class ShenyuConfig {
     private FallbackPath fallback = new FallbackPath();
     
     private ExtPlugin extPlugin = new ExtPlugin();
-    
+
     private Scheduler scheduler = new Scheduler();
-    
+
+    private PluginConfig plugin = new PluginConfig();
+
     private UpstreamCheck upstreamCheck = new UpstreamCheck();
 
     private CrossFilterConfig cross = new CrossFilterConfig();
@@ -75,6 +77,24 @@ public class ShenyuConfig {
 
     private String namespace = Constants.SYS_DEFAULT_NAMESPACE_ID;
 
+    /**
+     * get plugin config.
+     *
+     * @return plugin config
+     */
+    public PluginConfig getPlugin() {
+        return plugin;
+    }
+
+    /**
+     * set plugin config.
+     *
+     * @param plugin plugin config
+     */
+    public void setPlugin(final PluginConfig plugin) {
+        this.plugin = plugin;
+    }
+
     /**
      * shenyu bootstrap namespace.
      *
@@ -2113,4 +2133,50 @@ public void setAdmins(final String admins) {
             this.admins = admins;
         }
     }
+
+    /**
+     * The type Plugin config.
+     */
+    public static class PluginConfig {
+
+        private boolean enabled = true;
+
+        private long minCost;
+
+        /**
+         * Gets enabled.
+         *
+         * @return the enabled
+         */
+        public boolean getEnabled() {
+            return enabled;
+        }
+
+        /**
+         * Sets enabled.
+         *
+         * @param enabled the enabled
+         */
+        public void setEnabled(final boolean enabled) {
+            this.enabled = enabled;
+        }
+
+        /**
+         * Gets min cost.
+         *
+         * @return the min cost
+         */
+        public long getMinCost() {
+            return minCost;
+        }
+
+        /**
+         * Sets min cost.
+         *
+         * @param minCost the min cost
+         */
+        public void setMinCost(final long minCost) {
+            this.minCost = minCost;
+        }
+    }
 }
diff --git a/shenyu-common/src/main/java/org/apache/shenyu/common/constant/Constants.java b/shenyu-common/src/main/java/org/apache/shenyu/common/constant/Constants.java
index c597a6b72e56..2408b949e051 100644
--- a/shenyu-common/src/main/java/org/apache/shenyu/common/constant/Constants.java
+++ b/shenyu-common/src/main/java/org/apache/shenyu/common/constant/Constants.java
@@ -1078,6 +1078,16 @@ public interface Constants {
      */
     String GB = "GB";
 
+    /**
+     * the constant LOGGING_ENABLED.
+     */
+    String LOGGING_ENABLED = "loggingEnabled";
+
+    /**
+     * the constant LOGGING_MIN_COST.
+     */
+    String LOGGING_MIN_COST = "loggingMinCost";
+
     /**
      * String q.
      */
diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
index 22cfe72963c0..bd50500c5558 100644
--- a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
@@ -17,18 +17,14 @@
 
 package org.apache.shenyu.plugin.api;
 
-import org.apache.commons.lang3.ArrayUtils;
 import org.apache.shenyu.common.constant.Constants;
 import org.apache.shenyu.common.enums.RpcTypeEnum;
-import org.apache.shenyu.plugin.api.context.ShenyuContext;
+import org.apache.shenyu.plugin.api.utils.PluginSkipHelper;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.web.server.ServerWebExchange;
 import reactor.core.publisher.Mono;
 
-import java.util.Arrays;
-import java.util.Objects;
-
 /**
  * the shenyu plugin interface.
  */
@@ -93,12 +89,7 @@ default boolean skip(ServerWebExchange exchange) {
      * @return current rpcType == someone rpcType
      */
     default boolean skip(ServerWebExchange exchange, RpcTypeEnum... rpcTypes) {
-        if (ArrayUtils.isEmpty(rpcTypes)) {
-            return false;
-        }
-        ShenyuContext shenyuContext = exchange.getAttribute(Constants.CONTEXT);
-        Objects.requireNonNull(shenyuContext);
-        return Arrays.stream(rpcTypes).anyMatch(type -> Objects.equals(shenyuContext.getRpcType(), type.getName()));
+        return PluginSkipHelper.skip(exchange, rpcTypes);
     }
 
     /**
@@ -118,7 +109,7 @@ default boolean skip(ServerWebExchange exchange, RpcTypeEnum... rpcTypes) {
      * @return current rpcType != someone exceptRpcType
      */
     default boolean skipExcept(ServerWebExchange exchange, RpcTypeEnum... exceptRpcTypes) {
-        return !skip(exchange, exceptRpcTypes);
+        return PluginSkipHelper.skipExcept(exchange, exceptRpcTypes);
     }
 
     /**
@@ -129,7 +120,7 @@ default boolean skipExcept(ServerWebExchange exchange, RpcTypeEnum... exceptRpcT
      * @return http/spring cloud return true, others false.
      */
     default boolean skipExceptHttpLike(ServerWebExchange exchange) {
-        return !skip(exchange, RpcTypeEnum.HTTP, RpcTypeEnum.SPRING_CLOUD, RpcTypeEnum.AI);
+        return PluginSkipHelper.skipExceptHttpLike(exchange);
     }
 
     /**
@@ -147,9 +138,17 @@ default void before(ServerWebExchange exchange) {
      * @param exchange context
      */
     default void after(ServerWebExchange exchange) {
+        Boolean loggingEnabled = exchange.getAttributeOrDefault(Constants.LOGGING_ENABLED, true);
+        if (!loggingEnabled) {
+            return;
+        }
         long currentTimeMillis = System.currentTimeMillis();
         long startTime = (long) exchange.getAttributes().get(Constants.PLUGIN_START_TIME + named());
-        LOG.debug("shenyu traceId:{}, plugin named:{}, cost:{}", exchange.getLogPrefix(), named(), currentTimeMillis - startTime);
+        long cost = currentTimeMillis - startTime;
+        Long minCost = exchange.getAttributeOrDefault(Constants.LOGGING_MIN_COST, 0L);
+        if (cost >= minCost) {
+            LOG.info("shenyu traceId:{}, plugin named:{}, cost:{}", exchange.getLogPrefix(), named(), cost);
+        }
         exchange.getAttributes().remove(Constants.PLUGIN_START_TIME + named());
     }
 }
diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java
new file mode 100644
index 000000000000..ba1f86c0b6a4
--- /dev/null
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java
@@ -0,0 +1,92 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.shenyu.plugin.api.utils;
+
+import org.apache.commons.lang3.ArrayUtils;
+import org.apache.shenyu.common.constant.Constants;
+import org.apache.shenyu.common.enums.RpcTypeEnum;
+import org.apache.shenyu.plugin.api.context.ShenyuContext;
+import org.springframework.web.server.ServerWebExchange;
+
+import java.util.Arrays;
+import java.util.Objects;
+
+/**
+ * Plugin skip helper.
+ */
+public final class PluginSkipHelper {
+
+    private PluginSkipHelper() {
+    }
+
+    /**
+     * plugin is executed.
+     * if return true this plugin can not execute.
+     *
+     * <p>the same for:
+     * <pre>
+     * <code>Objects.equals(rpcType, typeA.getName())
+     * || Objects.equals(rpcType, typeB.getName())
+     * || Objects.equals(rpcType, type...getName())
+     * </code>
+     * </pre>
+     *
+     * @param exchange the current server exchange
+     * @param rpcTypes the skip rpc type list
+     * @return current rpcType == someone rpcType
+     */
+    public static boolean skip(final ServerWebExchange exchange, final RpcTypeEnum... rpcTypes) {
+        if (ArrayUtils.isEmpty(rpcTypes)) {
+            return false;
+        }
+        ShenyuContext shenyuContext = exchange.getAttribute(Constants.CONTEXT);
+        Objects.requireNonNull(shenyuContext);
+        return Arrays.stream(rpcTypes).anyMatch(type -> Objects.equals(shenyuContext.getRpcType(), type.getName()));
+    }
+
+    /**
+     * the plugin execute skip except some rpc types.
+     * if return true this plugin can not execute.
+     *
+     * <p>the same for:
+     * <pre>
+     * <code>!Objects.equals(rpcType, typeA.getName())
+     * &amp;&amp; !Objects.equals(rpcType, typeB.getName())
+     * &amp;&amp; !Objects.equals(rpcType, type...getName())
+     * </code>
+     * </pre>
+     *
+     * @param exchange the current server exchange
+     * @param exceptRpcTypes the except rpc type list
+     * @return current rpcType != someone exceptRpcType
+     */
+    public static boolean skipExcept(final ServerWebExchange exchange, final RpcTypeEnum... exceptRpcTypes) {
+        return !skip(exchange, exceptRpcTypes);
+    }
+
+    /**
+     * Skip the non http call.
+     * if return true this plugin can not execute.
+     *
+     * @param exchange the current server exchange
+     * @return http/spring cloud return true, others false.
+     */
+    public static boolean skipExceptHttpLike(final ServerWebExchange exchange) {
+        return !skip(exchange, RpcTypeEnum.HTTP, RpcTypeEnum.SPRING_CLOUD, RpcTypeEnum.AI);
+    }
+}
diff --git a/shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/ShenyuPluginTest.java b/shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/ShenyuPluginTest.java
new file mode 100644
index 000000000000..8074e797d974
--- /dev/null
+++ b/shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/ShenyuPluginTest.java
@@ -0,0 +1,168 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.shenyu.plugin.api;
+
+import org.apache.shenyu.common.constant.Constants;
+import org.apache.shenyu.common.enums.RpcTypeEnum;
+import org.apache.shenyu.plugin.api.context.ShenyuContext;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.mock.http.server.reactive.MockServerHttpRequest;
+import org.springframework.mock.web.server.MockServerWebExchange;
+import org.springframework.web.server.ServerWebExchange;
+import reactor.core.publisher.Mono;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * Test for ShenyuPlugin default methods.
+ */
+public class ShenyuPluginTest {
+
+    private ServerWebExchange exchange;
+
+    private ShenyuPlugin shenyuPlugin;
+
+    @BeforeEach
+    public void setUp() {
+        exchange = MockServerWebExchange.from(MockServerHttpRequest.get("localhost").build());
+        shenyuPlugin = new ShenyuPlugin() {
+            @Override
+            public Mono<Void> execute(final ServerWebExchange exchange, final ShenyuPluginChain chain) {
+                return chain.execute(exchange);
+            }
+
+            @Override
+            public int getOrder() {
+                return 0;
+            }
+
+            @Override
+            public String named() {
+                return "test-plugin";
+            }
+        };
+    }
+
+    @Test
+    public void testSkip() {
+        // Test default skip(exchange)
+        assertFalse(shenyuPlugin.skip(exchange));
+    }
+
+    @Test
+    public void testSkipWithRpcTypes() {
+        ShenyuContext context = mock(ShenyuContext.class);
+        exchange.getAttributes().put(Constants.CONTEXT, context);
+
+        // Match
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.HTTP.getName());
+        assertTrue(shenyuPlugin.skip(exchange, RpcTypeEnum.HTTP));
+
+        // No match
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.DUBBO.getName());
+        assertFalse(shenyuPlugin.skip(exchange, RpcTypeEnum.HTTP));
+
+        // Empty types
+        assertFalse(shenyuPlugin.skip(exchange));
+    }
+
+    @Test
+    public void testSkipExcept() {
+        ShenyuContext context = mock(ShenyuContext.class);
+        exchange.getAttributes().put(Constants.CONTEXT, context);
+
+        // Match (should not skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.HTTP.getName());
+        assertFalse(shenyuPlugin.skipExcept(exchange, RpcTypeEnum.HTTP));
+
+        // No match (should skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.DUBBO.getName());
+        assertTrue(shenyuPlugin.skipExcept(exchange, RpcTypeEnum.HTTP));
+    }
+
+    @Test
+    public void testSkipExceptHttpLike() {
+        ShenyuContext context = mock(ShenyuContext.class);
+        exchange.getAttributes().put(Constants.CONTEXT, context);
+
+        // HTTP (should not skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.HTTP.getName());
+        assertFalse(shenyuPlugin.skipExceptHttpLike(exchange));
+
+        // Spring Cloud (should not skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.SPRING_CLOUD.getName());
+        assertFalse(shenyuPlugin.skipExceptHttpLike(exchange));
+
+        // Dubbo (should skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.DUBBO.getName());
+        assertTrue(shenyuPlugin.skipExceptHttpLike(exchange));
+    }
+
+    @Test
+    public void testAfterWithLoggingEnabled() {
+        // Setup
+        exchange.getAttributes().put(Constants.LOGGING_ENABLED, true);
+        exchange.getAttributes().put(Constants.LOGGING_MIN_COST, 0L);
+        shenyuPlugin.before(exchange);
+
+        // Verify start time exists
+        assertTrue(exchange.getAttributes().containsKey(Constants.PLUGIN_START_TIME + shenyuPlugin.named()));
+
+        // Execute
+        shenyuPlugin.after(exchange);
+
+        // Verify start time removed (indicating full execution of after method)
+        assertFalse(exchange.getAttributes().containsKey(Constants.PLUGIN_START_TIME + shenyuPlugin.named()));
+    }
+
+    @Test
+    public void testAfterWithLoggingDisabled() {
+        // Setup
+        exchange.getAttributes().put(Constants.LOGGING_ENABLED, false);
+        shenyuPlugin.before(exchange);
+
+        // Verify start time exists
+        assertTrue(exchange.getAttributes().containsKey(Constants.PLUGIN_START_TIME + shenyuPlugin.named()));
+
+        // Execute
+        shenyuPlugin.after(exchange);
+
+        // Verify start time STILL exists (indicating early return)
+        assertTrue(exchange.getAttributes().containsKey(Constants.PLUGIN_START_TIME + shenyuPlugin.named()));
+    }
+
+    @Test
+    public void testAfterWithDefaultLoggingEnabled() {
+        // Setup (no LOGGING_ENABLED attribute, should default to true)
+        exchange.getAttributes().put(Constants.LOGGING_MIN_COST, 0L);
+        shenyuPlugin.before(exchange);
+
+        // Verify start time exists
+        assertTrue(exchange.getAttributes().containsKey(Constants.PLUGIN_START_TIME + shenyuPlugin.named()));
+
+        // Execute
+        shenyuPlugin.after(exchange);
+
+        // Verify start time removed
+        assertFalse(exchange.getAttributes().containsKey(Constants.PLUGIN_START_TIME + shenyuPlugin.named()));
+    }
+}
diff --git a/shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelperTest.java b/shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelperTest.java
new file mode 100644
index 000000000000..7bffc6a8e240
--- /dev/null
+++ b/shenyu-plugin/shenyu-plugin-api/src/test/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelperTest.java
@@ -0,0 +1,94 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.shenyu.plugin.api.utils;
+
+import org.apache.shenyu.common.constant.Constants;
+import org.apache.shenyu.common.enums.RpcTypeEnum;
+import org.apache.shenyu.plugin.api.context.ShenyuContext;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.mock.http.server.reactive.MockServerHttpRequest;
+import org.springframework.mock.web.server.MockServerWebExchange;
+import org.springframework.web.server.ServerWebExchange;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * Test for PluginSkipHelper.
+ */
+public final class PluginSkipHelperTest {
+
+    private ServerWebExchange exchange;
+
+    @BeforeEach
+    public void setUp() {
+        exchange = MockServerWebExchange.from(MockServerHttpRequest.get("localhost").build());
+    }
+
+    @Test
+    public void testSkip() {
+        ShenyuContext context = mock(ShenyuContext.class);
+        exchange.getAttributes().put(Constants.CONTEXT, context);
+
+        // Match
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.HTTP.getName());
+        assertTrue(PluginSkipHelper.skip(exchange, RpcTypeEnum.HTTP));
+
+        // No match
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.DUBBO.getName());
+        assertFalse(PluginSkipHelper.skip(exchange, RpcTypeEnum.HTTP));
+
+        // Empty types
+        assertFalse(PluginSkipHelper.skip(exchange));
+    }
+
+    @Test
+    public void testSkipExcept() {
+        ShenyuContext context = mock(ShenyuContext.class);
+        exchange.getAttributes().put(Constants.CONTEXT, context);
+
+        // Match (should not skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.HTTP.getName());
+        assertFalse(PluginSkipHelper.skipExcept(exchange, RpcTypeEnum.HTTP));
+
+        // No match (should skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.DUBBO.getName());
+        assertTrue(PluginSkipHelper.skipExcept(exchange, RpcTypeEnum.HTTP));
+    }
+
+    @Test
+    public void testSkipExceptHttpLike() {
+        ShenyuContext context = mock(ShenyuContext.class);
+        exchange.getAttributes().put(Constants.CONTEXT, context);
+
+        // HTTP (should not skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.HTTP.getName());
+        assertFalse(PluginSkipHelper.skipExceptHttpLike(exchange));
+
+        // Spring Cloud (should not skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.SPRING_CLOUD.getName());
+        assertFalse(PluginSkipHelper.skipExceptHttpLike(exchange));
+
+        // Dubbo (should skip)
+        when(context.getRpcType()).thenReturn(RpcTypeEnum.DUBBO.getName());
+        assertTrue(PluginSkipHelper.skipExceptHttpLike(exchange));
+    }
+}
diff --git a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
index 460d113f9217..b7a4b1e57fbb 100644
--- a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
+++ b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
@@ -44,6 +44,8 @@
 import java.util.Map;
 import java.util.Objects;
 import java.util.Optional;
+import java.util.concurrent.atomic.AtomicInteger;
+import java.util.function.Function;
 import java.util.stream.Collectors;
 
 /**
@@ -54,7 +56,7 @@ public final class ShenyuWebHandler implements WebHandler, ApplicationListener<P
     private static final Logger LOG = LoggerFactory.getLogger(ShenyuWebHandler.class);
 
     /**
-     * this filed can not set to be final, because we should copyOnWrite to update plugins.
+     * this field uses volatile List for thread-safe operations.
      */
     private volatile List<ShenyuPlugin> plugins;
 
@@ -67,8 +69,10 @@ public final class ShenyuWebHandler implements WebHandler, ApplicationListener<P
 
     private final boolean scheduled;
 
+    private final ShenyuConfig shenyuConfig;
+
     private Scheduler scheduler;
-    
+
     /**
      * Instantiates a new shenyu web handler.
      *
@@ -80,6 +84,7 @@ public ShenyuWebHandler(final List<ShenyuPlugin> plugins, final ShenyuLoaderServ
         this.sourcePlugins = new ArrayList<>(plugins);
         this.plugins = new ArrayList<>(plugins);
         this.shenyuLoaderService = shenyuLoaderService;
+        this.shenyuConfig = shenyuConfig;
         ShenyuConfig.Scheduler config = shenyuConfig.getScheduler();
         this.scheduled = config.getEnabled();
         if (scheduled) {
@@ -98,6 +103,8 @@ public ShenyuWebHandler(final List<ShenyuPlugin> plugins, final ShenyuLoaderServ
      */
     public void before(final ServerWebExchange exchange) {
         exchange.getAttributes().put(Constants.CHAIN_START_TIME, System.currentTimeMillis());
+        exchange.getAttributes().put(Constants.LOGGING_ENABLED, shenyuConfig.getPlugin().getEnabled());
+        exchange.getAttributes().put(Constants.LOGGING_MIN_COST, shenyuConfig.getPlugin().getMinCost());
     }
 
     /**
@@ -147,47 +154,74 @@ public List<ShenyuPlugin> getPlugins() {
      *
      * @param extPlugins the ext plugins
      */
-    public void putExtPlugins(final List<ShenyuPlugin> extPlugins) {
+    public synchronized void putExtPlugins(final List<ShenyuPlugin> extPlugins) {
         if (CollectionUtils.isEmpty(extPlugins)) {
             return;
         }
-        final List<ShenyuPlugin> shenyuAddPlugins = extPlugins.stream()
-                .filter(e -> plugins.stream().noneMatch(plugin -> plugin.named().equals(e.named())))
-                .collect(Collectors.toList());
 
-        final List<ShenyuPlugin> shenyuUpdatePlugins = extPlugins.stream()
-                .filter(e -> plugins.stream().anyMatch(plugin -> plugin.named().equals(e.named())))
-                .collect(Collectors.toList());
+        // Copy-on-write: create new list based on current volatile list
+        List<ShenyuPlugin> newPlugins = new ArrayList<>(this.plugins);
 
-        if (CollectionUtils.isEmpty(shenyuAddPlugins) && CollectionUtils.isEmpty(shenyuUpdatePlugins)) {
-            return;
+        // Create a map of existing plugins for O(1) lookup
+        Map<String, ShenyuPlugin> existingPluginMap = newPlugins.stream()
+                .collect(Collectors.toMap(ShenyuPlugin::named, Function.identity()));
+
+        boolean hasAdditions = false;
+        boolean hasUpdates = false;
+
+        // Single pass through extPlugins to handle both additions and updates
+        for (ShenyuPlugin extPlugin : extPlugins) {
+            String pluginName = extPlugin.named();
+            if (existingPluginMap.containsKey(pluginName)) {
+                // Update existing plugin
+                updatePluginInList(extPlugin, newPlugins);
+                updatePluginInSource(extPlugin);
+                hasUpdates = true;
+                LOG.info("shenyu auto update extends plugins:{}", pluginName);
+            } else {
+                // Add new plugin
+                newPlugins.add(extPlugin);
+                this.sourcePlugins.add(extPlugin);
+                hasAdditions = true;
+                LOG.info("shenyu auto add extends plugins:{}", pluginName);
+            }
         }
-        // copy new list
-        List<ShenyuPlugin> newPluginList = new ArrayList<>(plugins);
-        
-        // Add extend plugin from pluginData or shenyu ext-lib
-        this.sourcePlugins.addAll(shenyuAddPlugins);
-
-        if (CollectionUtils.isNotEmpty(shenyuAddPlugins)) {
-            shenyuAddPlugins.forEach(plugin -> LOG.info("shenyu auto add extends plugins:{}", plugin.named()));
-            newPluginList.addAll(shenyuAddPlugins);
+
+        if (hasAdditions || hasUpdates) {
+            // Re-sort the plugins list
+            List<ShenyuPlugin> sortedPlugins = sortPlugins(newPlugins);
+            // Volatile write
+            this.plugins = sortedPlugins;
         }
-        if (CollectionUtils.isNotEmpty(shenyuUpdatePlugins)) {
-            shenyuUpdatePlugins.forEach(plugin -> LOG.info("shenyu auto update extends plugins:{}", plugin.named()));
-            for (ShenyuPlugin updatePlugin : shenyuUpdatePlugins) {
-                for (int i = 0; i < newPluginList.size(); i++) {
-                    if (newPluginList.get(i).named().equals(updatePlugin.named())) {
-                        newPluginList.set(i, updatePlugin);
-                    }
-                }
-                for (int i = 0; i < this.sourcePlugins.size(); i++) {
-                    if (this.sourcePlugins.get(i).named().equals(updatePlugin.named())) {
-                        this.sourcePlugins.set(i, updatePlugin);
-                    }
-                }
+    }
+
+    /**
+     * Update plugin in the given plugin list.
+     *
+     * @param updatePlugin the plugin to update
+     * @param pluginList the plugin list to update
+     */
+    private void updatePluginInList(final ShenyuPlugin updatePlugin, final List<ShenyuPlugin> pluginList) {
+        for (int i = 0; i < pluginList.size(); i++) {
+            if (pluginList.get(i).named().equals(updatePlugin.named())) {
+                pluginList.set(i, updatePlugin);
+                break;
+            }
+        }
+    }
+
+    /**
+     * Update plugin in the source plugins list.
+     *
+     * @param updatePlugin the plugin to update
+     */
+    private void updatePluginInSource(final ShenyuPlugin updatePlugin) {
+        for (int i = 0; i < this.sourcePlugins.size(); i++) {
+            if (this.sourcePlugins.get(i).named().equals(updatePlugin.named())) {
+                this.sourcePlugins.set(i, updatePlugin);
+                break;
             }
         }
-        plugins = sortPlugins(newPluginList);
     }
 
     /**
@@ -196,7 +230,7 @@ public void putExtPlugins(final List<ShenyuPlugin> extPlugins) {
      * @param event sort plugin event
      */
     @Override
-    public void onApplicationEvent(final PluginHandlerEvent event) {
+    public synchronized void onApplicationEvent(final PluginHandlerEvent event) {
         PluginHandlerEventEnum stateEnums = event.getPluginStateEnums();
         PluginData pluginData = (PluginData) event.getSource();
         switch (stateEnums) {
@@ -209,8 +243,12 @@ public void onApplicationEvent(final PluginHandlerEvent event) {
                 onPluginRemoved(pluginData);
                 break;
             case SORTED:
-                // copy a new one, or there will be concurrency problems
-                this.plugins = sortPlugins(new ArrayList<>(this.plugins));
+                // Re-sort the plugins list
+                // Copy-on-write
+                List<ShenyuPlugin> newPlugins = new ArrayList<>(this.plugins);
+                List<ShenyuPlugin> sortedPlugins = sortPlugins(newPlugins);
+                // Volatile write
+                this.plugins = sortedPlugins;
                 break;
             default:
                 throw new IllegalStateException("Unexpected value: " + event.getPluginStateEnums());
@@ -237,7 +275,7 @@ private List<ShenyuPlugin> sortPlugins(final List<ShenyuPlugin> list) {
      *
      * @param pluginData plugin data
      */
-    private synchronized void onPluginEnabled(final PluginData pluginData) {
+    private void onPluginEnabled(final PluginData pluginData) {
         LOG.info("shenyu use plugin:[{}]", pluginData.getName());
         if (StringUtils.isNoneBlank(pluginData.getPluginJar())) {
             LOG.info("shenyu start load plugin [{}] from upload plugin jar", pluginData.getName());
@@ -245,11 +283,18 @@ private synchronized void onPluginEnabled(final PluginData pluginData) {
         }
         final List<ShenyuPlugin> enabledPlugins = this.sourcePlugins.stream().filter(plugin -> plugin.named().equals(pluginData.getName())
                 && pluginData.getEnabled()).collect(Collectors.toList());
-        enabledPlugins.removeAll(this.plugins);
-        // copy a new plugin list.
-        List<ShenyuPlugin> newPluginList = new ArrayList<>(this.plugins);
-        newPluginList.addAll(enabledPlugins);
-        this.plugins = sortPlugins(newPluginList);
+
+        // Copy-on-write
+        List<ShenyuPlugin> newPlugins = new ArrayList<>(this.plugins);
+        enabledPlugins.removeAll(newPlugins);
+        if (!enabledPlugins.isEmpty()) {
+            // Add enabled plugins
+            newPlugins.addAll(enabledPlugins);
+            // Re-sort the plugins list
+            List<ShenyuPlugin> sortedPlugins = sortPlugins(newPlugins);
+            // Volatile write
+            this.plugins = sortedPlugins;
+        }
     }
 
     /**
@@ -257,19 +302,21 @@ private synchronized void onPluginEnabled(final PluginData pluginData) {
      *
      * @param pluginData plugin data
      */
-    private synchronized void onPluginRemoved(final PluginData pluginData) {
-        // copy a new plugin list.
-        List<ShenyuPlugin> newPluginList = new ArrayList<>(this.plugins);
-        newPluginList.removeIf(plugin -> plugin.named().equals(pluginData.getName()));
-        this.plugins = newPluginList;
+    private void onPluginRemoved(final PluginData pluginData) {
+        // Copy-on-write
+        List<ShenyuPlugin> newPlugins = new ArrayList<>(this.plugins);
+        // Remove plugin from plugins list
+        newPlugins.removeIf(plugin -> plugin.named().equals(pluginData.getName()));
+        // Volatile write
+        this.plugins = newPlugins;
     }
 
     private static class DefaultShenyuPluginChain implements ShenyuPluginChain {
 
-        private int index;
+        private final AtomicInteger index = new AtomicInteger(0);
 
         private final List<ShenyuPlugin> plugins;
-    
+
         /**
          * Instantiates a new Default shenyu plugin chain.
          *
@@ -288,11 +335,11 @@ private static class DefaultShenyuPluginChain implements ShenyuPluginChain {
         @Override
         public Mono<Void> execute(final ServerWebExchange exchange) {
             return Mono.defer(() -> {
-                if (this.index < plugins.size()) {
-                    ShenyuPlugin plugin = plugins.get(this.index++);
-                    boolean skip = plugin.skip(exchange);
-                    if (skip) {
-                        return this.execute(exchange);
+                int pos;
+                while ((pos = index.getAndIncrement()) < plugins.size()) {
+                    ShenyuPlugin plugin = plugins.get(pos);
+                    if (plugin.skip(exchange)) {
+                        continue;
                     }
                     try {
                         plugin.before(exchange);
diff --git a/shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerRecursionTest.java b/shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerRecursionTest.java
new file mode 100644
index 000000000000..a07afafa1f51
--- /dev/null
+++ b/shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerRecursionTest.java
@@ -0,0 +1,124 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.shenyu.web.handler;
+
+import org.apache.shenyu.common.config.ShenyuConfig;
+import org.apache.shenyu.common.constant.Constants;
+import org.apache.shenyu.plugin.api.ShenyuPlugin;
+import org.apache.shenyu.plugin.api.ShenyuPluginChain;
+import org.apache.shenyu.plugin.api.context.ShenyuContext;
+import org.apache.shenyu.web.loader.ShenyuLoaderService;
+import org.junit.jupiter.api.Test;
+import org.springframework.mock.http.server.reactive.MockServerHttpRequest;
+import org.springframework.mock.web.server.MockServerWebExchange;
+import org.springframework.web.server.ServerWebExchange;
+import reactor.core.publisher.Mono;
+import reactor.test.StepVerifier;
+
+import java.net.InetSocketAddress;
+import java.util.ArrayList;
+import java.util.List;
+
+import static org.mockito.Mockito.mock;
+
+public class ShenyuWebHandlerRecursionTest {
+
+    @Test
+    public void testManySkippedPlugins() {
+        int pluginCount = 10000;
+        List<ShenyuPlugin> plugins = new ArrayList<>(pluginCount);
+
+        // Add many skipped plugins
+        for (int i = 0; i < pluginCount; i++) {
+            plugins.add(new SkippedPlugin(i));
+        }
+
+        // Add one final executed plugin
+        plugins.add(new ExecutedPlugin(pluginCount));
+
+        ShenyuLoaderService shenyuLoaderService = mock(ShenyuLoaderService.class);
+        ShenyuWebHandler handler = new ShenyuWebHandler(plugins, shenyuLoaderService, new ShenyuConfig());
+
+        ServerWebExchange exchange = MockServerWebExchange.from(MockServerHttpRequest.get("localhost")
+                .remoteAddress(new InetSocketAddress(8090))
+                .build());
+        exchange.getAttributes().put(Constants.CONTEXT, mock(ShenyuContext.class));
+
+        Mono<Void> result = handler.handle(exchange);
+
+        StepVerifier.create(result)
+                .expectSubscription()
+                .verifyComplete();
+    }
+
+    static class SkippedPlugin implements ShenyuPlugin {
+        private final int order;
+
+        SkippedPlugin(final int order) {
+            this.order = order;
+        }
+
+        @Override
+        public Mono<Void> execute(final ServerWebExchange exchange, final ShenyuPluginChain chain) {
+            return chain.execute(exchange);
+        }
+
+        @Override
+        public int getOrder() {
+            return order;
+        }
+
+        @Override
+        public String named() {
+            return "skipped-" + order;
+        }
+
+        @Override
+        public boolean skip(final ServerWebExchange exchange) {
+            return true;
+        }
+    }
+
+    static class ExecutedPlugin implements ShenyuPlugin {
+        private final int order;
+
+        ExecutedPlugin(final int order) {
+            this.order = order;
+        }
+
+        @Override
+        public Mono<Void> execute(final ServerWebExchange exchange, final ShenyuPluginChain chain) {
+            return chain.execute(exchange);
+        }
+
+        @Override
+        public int getOrder() {
+            return order;
+        }
+
+        @Override
+        public String named() {
+            return "executed-" + order;
+        }
+
+        @Override
+        public boolean skip(final ServerWebExchange exchange) {
+            return false;
+        }
+    }
+}
diff --git a/shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerTest.java b/shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerTest.java
index bc720c905f16..9371e53f270c 100644
--- a/shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerTest.java
+++ b/shenyu-web/src/test/java/org/apache/shenyu/web/handler/ShenyuWebHandlerTest.java
@@ -41,8 +41,12 @@
 
 import java.net.InetSocketAddress;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
@@ -89,9 +93,88 @@ public void handle() {
 
     @Test
     public void putExtPlugins() {
+        // Test empty list
         shenyuWebHandler.putExtPlugins(Collections.emptyList());
-        shenyuWebHandler.putExtPlugins(Collections.singletonList(new TestPlugin2()));
-        shenyuWebHandler.putExtPlugins(Collections.singletonList(new TestPlugin3()));
+
+        // Test adding new plugin
+        ShenyuPlugin newPlugin = new TestPlugin3();
+        shenyuWebHandler.putExtPlugins(Collections.singletonList(newPlugin));
+        List<ShenyuPlugin> pluginsAfterAdd = (List<ShenyuPlugin>) ReflectionTestUtils.getField(shenyuWebHandler, "plugins");
+        assertTrue(pluginsAfterAdd.contains(newPlugin));
+
+        // Test updating existing plugin
+        ShenyuPlugin updatedPlugin2 = new TestPlugin2() {
+            @Override
+            public int getOrder() {
+                return 999;
+            }
+        };
+        shenyuWebHandler.putExtPlugins(Collections.singletonList(updatedPlugin2));
+        List<ShenyuPlugin> pluginsAfterUpdate = (List<ShenyuPlugin>) ReflectionTestUtils.getField(shenyuWebHandler, "plugins");
+
+        // Verify that the updated plugin is in the list and has the new order
+        boolean foundUpdated = false;
+        for (ShenyuPlugin plugin : pluginsAfterUpdate) {
+            if ("test-plugin2".equals(plugin.named()) && plugin.getOrder() == 999) {
+                foundUpdated = true;
+                break;
+            }
+        }
+        assertTrue(foundUpdated);
+
+        // Test mixed add and update
+        ShenyuPlugin anotherNewPlugin = new TestPlugin4();
+        shenyuWebHandler.putExtPlugins(Arrays.asList(updatedPlugin2, anotherNewPlugin));
+        List<ShenyuPlugin> pluginsAfterMixed = (List<ShenyuPlugin>) ReflectionTestUtils.getField(shenyuWebHandler, "plugins");
+        assertTrue(pluginsAfterMixed.contains(anotherNewPlugin));
+    }
+
+    @Test
+    public void concurrentPutExtPlugins() throws InterruptedException {
+        // Create multiple threads that concurrently add plugins
+        int threadCount = 10;
+        CountDownLatch latch = new CountDownLatch(threadCount);
+        ExecutorService executor = Executors.newFixedThreadPool(threadCount);
+
+        for (int i = 0; i < threadCount; i++) {
+            final int pluginIndex = i;
+            executor.submit(() -> {
+                try {
+                    ShenyuPlugin plugin = new ShenyuPlugin() {
+                        @Override
+                        public Mono<Void> execute(final ServerWebExchange exchange, final ShenyuPluginChain chain) {
+                            return chain.execute(exchange);
+                        }
+
+                        @Override
+                        public int getOrder() {
+                            return pluginIndex;
+                        }
+
+                        @Override
+                        public String named() {
+                            return "concurrent-plugin-" + pluginIndex;
+                        }
+                    };
+                    shenyuWebHandler.putExtPlugins(Collections.singletonList(plugin));
+                } finally {
+                    latch.countDown();
+                }
+            });
+        }
+
+        latch.await();
+        executor.shutdown();
+
+        // Verify that all plugins were added
+        List<ShenyuPlugin> plugins = (List<ShenyuPlugin>) ReflectionTestUtils.getField(shenyuWebHandler, "plugins");
+        int concurrentPluginCount = 0;
+        for (ShenyuPlugin plugin : plugins) {
+            if (plugin.named().startsWith("concurrent-plugin-")) {
+                concurrentPluginCount++;
+            }
+        }
+        assertEquals(threadCount, concurrentPluginCount);
     }
 
     @Test
@@ -221,4 +304,27 @@ public boolean skip(final ServerWebExchange exchange) {
             return ShenyuPlugin.super.skip(exchange);
         }
     }
+
+    static class TestPlugin4 implements ShenyuPlugin {
+
+        @Override
+        public Mono<Void> execute(final ServerWebExchange exchange, final ShenyuPluginChain chain) {
+            return chain.execute(exchange);
+        }
+
+        @Override
+        public int getOrder() {
+            return 4;
+        }
+
+        @Override
+        public String named() {
+            return "test-plugin4";
+        }
+
+        @Override
+        public boolean skip(final ServerWebExchange exchange) {
+            return ShenyuPlugin.super.skip(exchange);
+        }
+    }
 }

From 6204c3a4bf4242d6995b4a493bd15b773cb06051 Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Tue, 13 Jan 2026 09:37:59 +0800
Subject: [PATCH 02/16] refactor: implement Maven profiles for bootstrap
 dependency slimming

- Modularize shenyu-bootstrap dependencies into profiles
- Create 'standard' (default), 'minimal', 'rpc', 'logging', 'ai', 'mcp' profiles
- Add documentation in docs/BOOTSTRAP_PROFILES.md
---
 docs/BOOTSTRAP_PROFILES.md |  50 ++
 shenyu-bootstrap/pom.xml   | 935 ++++++++++++++++---------------------
 2 files changed, 449 insertions(+), 536 deletions(-)
 create mode 100644 docs/BOOTSTRAP_PROFILES.md

diff --git a/docs/BOOTSTRAP_PROFILES.md b/docs/BOOTSTRAP_PROFILES.md
new file mode 100644
index 000000000000..57dcec5e0178
--- /dev/null
+++ b/docs/BOOTSTRAP_PROFILES.md
@@ -0,0 +1,50 @@
+# ShenYu Bootstrap Build Profiles
+
+This document describes the Maven profiles available for building `shenyu-bootstrap`.
+
+## Overview
+
+To optimize startup time and package size, `shenyu-bootstrap` dependencies have been modularized into Maven profiles. You can choose which set of plugins to include in your build.
+
+## Profiles
+
+| Profile ID | Description | Included Components | Activation |
+|------------|-------------|---------------------|------------|
+| `standard` | **Default**. Common Gateway features. | RateLimiter, Resilience4j, WAF, Sign, JWT, OAuth2, Metrics, WebSocket, all Data Sync methods. | **Active by default** |
+| `minimal` | Core Gateway only. | Param-mapping, Request/Response transformation, Context-path, Cryptor. | Use `-P !standard` |
+| `rpc` | RPC support. | Apache Dubbo, Sofa, Motan, Tars, gRPC, TCP. | Manual (`-P rpc`) |
+| `logging` | Advanced logging. | RocketMQ, Kafka, RabbitMQ, Elasticsearch, Pulsar, ClickHouse, etc. | Manual (`-P logging`) |
+| `ai` | AI Proxy support. | AI Proxy, AI Prompt, Token Limiter, Transformers. | Manual (`-P ai`) |
+| `mcp` | Model Context Protocol. | MCP Server plugin. | Manual (`-P mcp`) |
+
+## Usage Examples
+
+### 1. Build Standard Version (Default)
+Includes common plugins and all data sync options.
+```bash
+mvn clean package -pl shenyu-bootstrap -am
+```
+
+### 2. Build Minimal Version
+Only the core gateway runtime. Useful for lightweight sidecars or simple proxies.
+```bash
+mvn clean package -pl shenyu-bootstrap -am -P !standard
+```
+
+### 3. Build with RPC Support
+Standard features + Dubbo, Sofa, etc.
+```bash
+mvn clean package -pl shenyu-bootstrap -am -P rpc
+```
+
+### 4. Build Full Version (All Features)
+```bash
+mvn clean package -pl shenyu-bootstrap -am -P rpc,logging,ai,mcp
+```
+(Note: `standard` is included by default, so you don't need to list it unless you disabled it)
+
+### 5. Custom Combination
+Example: Minimal core + Dubbo + Kafka Logging
+```bash
+mvn clean package -pl shenyu-bootstrap -am -P !standard,rpc,logging
+```
diff --git a/shenyu-bootstrap/pom.xml b/shenyu-bootstrap/pom.xml
index abe6c1598f4b..54d24a6cd74e 100644
--- a/shenyu-bootstrap/pom.xml
+++ b/shenyu-bootstrap/pom.xml
@@ -31,594 +31,456 @@
     </properties>
 
     <dependencies>
+        <!-- Spring Boot Starters -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-webflux</artifactId>
         </dependency>
-
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-actuator</artifactId>
         </dependency>
 
-        <!--shenyu gateway start-->
+        <!-- ShenYu Gateway Core -->
         <dependency>
             <groupId>org.apache.shenyu</groupId>
             <artifactId>shenyu-spring-boot-starter-gateway</artifactId>
             <version>${project.version}</version>
         </dependency>
 
-        <!--shenyu param mapping plugin start-->
+        <!-- Essential Plugins -->
         <dependency>
             <groupId>org.apache.shenyu</groupId>
             <artifactId>shenyu-spring-boot-starter-plugin-param-mapping</artifactId>
             <version>${project.version}</version>
         </dependency>
-        <!--shenyu param mapping end-->
-
-        <!-- shenyu waf plugin starter-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-waf</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu waf plugin end-->
-
-        <!-- shenyu ratelimiter plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-ratelimiter</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu ratelimiter plugin end-->
-
-        <!-- shenyu hystrix plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-hystrix</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu hystrix plugin end-->
-
-        <!-- shenyu resilience4j plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-resilience4j</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu resilience4j plugin end-->
-
-        <!-- shenyu sentinel plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-sentinel</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu sentinel plugin end-->
-
-        <!-- shenyu redirect plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-redirect</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu redirect plugin end-->
-
-        <!-- shenyu redirect plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-rewrite</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu redirect plugin end-->
-
-        <!-- shenyu request plugin start-->
         <dependency>
             <groupId>org.apache.shenyu</groupId>
             <artifactId>shenyu-spring-boot-starter-plugin-request</artifactId>
             <version>${project.version}</version>
         </dependency>
-        <!-- shenyu request plugin end-->
-
-        <!--shenyu debug plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-console</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu debug plugin end-->
-
-        <!-- shenyu sign plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-sign</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu sign plugin end-->
-
-        <!--shenyu oauth2 plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-oauth2</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu oauth2 plugin end-->
-
-        <!--shenyu jwt plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-jwt</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu jwt end-->
-
-        <!--shenyu casdoor plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-casdoor</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu auth plugin end-->
-
-        <!-- shenyu modify response plugin start-->
         <dependency>
             <groupId>org.apache.shenyu</groupId>
             <artifactId>shenyu-spring-boot-starter-plugin-modify-response</artifactId>
             <version>${project.version}</version>
         </dependency>
-        <!-- shenyu modify response plugin end-->
-
-        <!--shenyu cryptor plugin start-->
         <dependency>
             <groupId>org.apache.shenyu</groupId>
             <artifactId>shenyu-spring-boot-starter-plugin-cryptor</artifactId>
             <version>${project.version}</version>
         </dependency>
-        <!--shenyu cryptor end-->
-
-        <!--shenyu general context plugin start-->
         <dependency>
             <groupId>org.apache.shenyu</groupId>
             <artifactId>shenyu-spring-boot-starter-plugin-general-context</artifactId>
             <version>${project.version}</version>
         </dependency>
-        <!--shenyu general context plugin end-->
-
-        <!--shenyu websocket plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-websocket</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu websocket plugin end-->
-
-        <!--shenyu metrics plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-metrics</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu metrics plugin end-->
-
-        <!--shenyu cache plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-cache</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu cache plugin end-->
-
-
-        <!--shenyu grpc plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-grpc</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu grpc plugin end-->
-
-        <!--shenyu tars plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-tars</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-
-        <dependency>
-            <groupId>com.tencent.tars</groupId>
-            <artifactId>tars-client</artifactId>
-            <version>1.7.2</version>
-        </dependency>
-        <!--shenyu tars plugin end-->
-
-        <!--Tcp Plugin Start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-tcp</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--Tcp Plugin end-->
-
-        <!--Ai proxy Plugin Start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-ai-proxy</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--Ai proxy Plugin end-->
-        
-        <!--Ai prompt Plugin Start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-ai-prompt</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--Ai prompt Plugin end-->
-
-        <!--Ai token limiter Plugin Start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-ai-token-limiter</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--Ai token limiter Plugin end-->
-
-        <!--Ai request transformer Plugin Start-->
         <dependency>
             <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-ai-request-transformer</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--Ai request transformer Plugin end-->
-
-        <!--Ai response transformer Plugin Start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-ai-response-transformer</artifactId>
+            <artifactId>shenyu-spring-boot-starter-client-beat</artifactId>
             <version>${project.version}</version>
         </dependency>
-        <!--Ai response transformer Plugin end-->
+    </dependencies>
 
-        <!--Mcp Server Plugin Start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-mcp-server</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--Mcp Server Plugin end-->
+    <profiles>
+        <!-- Standard Profile: Common plugins and Data Sync (Active by default) -->
+        <profile>
+            <id>standard</id>
+            <activation>
+                <activeByDefault>true</activeByDefault>
+            </activation>
+            <dependencies>
+                <!-- Resilience & Limiting -->
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-ratelimiter</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-hystrix</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-resilience4j</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-sentinel</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <!-- Security & Auth -->
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-waf</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-sign</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-jwt</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-oauth2</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-casdoor</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-basic-auth</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-key-auth</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <!-- Traffic Control -->
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-rewrite</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-redirect</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <!-- Monitoring & Utility -->
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-metrics</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-cache</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-websocket</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-mock</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-console</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <!-- Data Sync -->
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-sync-data-zookeeper</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-sync-data-websocket</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-sync-data-http</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-sync-data-nacos</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-sync-data-etcd</artifactId>
+                    <version>${project.version}</version>
+                    <exclusions>
+                        <exclusion>
+                            <groupId>io.grpc</groupId>
+                            <artifactId>grpc-grpclb</artifactId>
+                        </exclusion>
+                        <exclusion>
+                            <groupId>io.grpc</groupId>
+                            <artifactId>grpc-netty</artifactId>
+                        </exclusion>
+                    </exclusions>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-sync-data-consul</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-sync-data-polaris</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+            </dependencies>
+        </profile>
 
-        <!--shenyu sofa plugin start-->
-        <dependency>
-            <groupId>com.alipay.sofa</groupId>
-            <artifactId>sofa-rpc-all</artifactId>
-            <exclusions>
-                <exclusion>
-                    <groupId>net.jcip</groupId>
-                    <artifactId>jcip-annotations</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>io.grpc</groupId>
-                    <artifactId>grpc-core</artifactId>
-                </exclusion>
-                <exclusion>
-                    <artifactId>commons-io</artifactId>
-                    <groupId>commons-io</groupId>
-                </exclusion>
-                <exclusion>
-                    <artifactId>okio</artifactId>
-                    <groupId>com.squareup.okio</groupId>
-                </exclusion>
-                <exclusion>
-                    <artifactId>sofa-common-tools</artifactId>
+        <!-- RPC Profile: Dubbo, Sofa, Motan, Tars, gRPC -->
+        <profile>
+            <id>rpc</id>
+            <dependencies>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-apache-dubbo</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.dubbo</groupId>
+                    <artifactId>dubbo</artifactId>
+                    <version>${apache.dubbo.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.dubbo</groupId>
+                    <artifactId>dubbo-dependencies-zookeeper</artifactId>
+                    <version>${apache.dubbo.version}</version>
+                    <exclusions>
+                        <exclusion>
+                            <artifactId>slf4j-log4j12</artifactId>
+                            <groupId>org.slf4j</groupId>
+                        </exclusion>
+                    </exclusions>
+                    <type>pom</type>
+                </dependency>
+
+                <dependency>
+                    <groupId>com.alipay.sofa</groupId>
+                    <artifactId>sofa-rpc-all</artifactId>
+                    <exclusions>
+                        <exclusion>
+                            <groupId>net.jcip</groupId>
+                            <artifactId>jcip-annotations</artifactId>
+                        </exclusion>
+                        <exclusion>
+                            <groupId>io.grpc</groupId>
+                            <artifactId>grpc-core</artifactId>
+                        </exclusion>
+                        <exclusion>
+                            <artifactId>commons-io</artifactId>
+                            <groupId>commons-io</groupId>
+                        </exclusion>
+                        <exclusion>
+                            <artifactId>okio</artifactId>
+                            <groupId>com.squareup.okio</groupId>
+                        </exclusion>
+                        <exclusion>
+                            <artifactId>sofa-common-tools</artifactId>
+                            <groupId>com.alipay.sofa.common</groupId>
+                        </exclusion>
+                    </exclusions>
+                </dependency>
+                <dependency>
                     <groupId>com.alipay.sofa.common</groupId>
-                </exclusion>
-            </exclusions>
-        </dependency>
-        <dependency>
-            <groupId>com.alipay.sofa.common</groupId>
-            <artifactId>sofa-common-tools</artifactId>
-            <version>${sofa-common-tools.version}</version>
-            <exclusions>
-                <exclusion>
-                    <artifactId>guava</artifactId>
-                    <groupId>com.google.guava</groupId>
-                </exclusion>
-            </exclusions>
-        </dependency>
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-sofa</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu sofa plugin end-->
-
-        <dependency>
-            <groupId>com.alibaba.cloud</groupId>
-            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
-            <version>${nacos-discovery.version}</version>
-            <exclusions>
-                <exclusion>
+                    <artifactId>sofa-common-tools</artifactId>
+                    <version>${sofa-common-tools.version}</version>
+                    <exclusions>
+                        <exclusion>
+                            <artifactId>guava</artifactId>
+                            <groupId>com.google.guava</groupId>
+                        </exclusion>
+                    </exclusions>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-sofa</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <dependency>
+                    <groupId>com.weibo</groupId>
+                    <artifactId>motan-core</artifactId>
+                    <version>${motan.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>com.weibo</groupId>
+                    <artifactId>motan-transport-netty4</artifactId>
+                    <version>${motan.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>com.weibo</groupId>
+                    <artifactId>motan-registry-zookeeper</artifactId>
+                    <version>${motan.version}</version>
+                    <exclusions>
+                        <exclusion>
+                            <groupId>log4j</groupId>
+                            <artifactId>log4j</artifactId>
+                        </exclusion>
+                        <exclusion>
+                            <groupId>org.slf4j</groupId>
+                            <artifactId>slf4j-log4j12</artifactId>
+                        </exclusion>
+                    </exclusions>
+                </dependency>
+                <dependency>
+                    <groupId>com.weibo</groupId>
+                    <artifactId>motan-springsupport</artifactId>
+                    <version>${motan.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-motan</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-grpc</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-tars</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>com.tencent.tars</groupId>
+                    <artifactId>tars-client</artifactId>
+                    <version>1.7.2</version>
+                </dependency>
+
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-tcp</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+
+                <dependency>
+                    <groupId>com.alibaba.cloud</groupId>
+                    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+                    <version>${nacos-discovery.version}</version>
+                    <exclusions>
+                        <exclusion>
+                            <groupId>org.springframework.cloud</groupId>
+                            <artifactId>spring-cloud-loadbalancer</artifactId>
+                        </exclusion>
+                    </exclusions>
+                </dependency>
+                <dependency>
                     <groupId>org.springframework.cloud</groupId>
-                    <artifactId>spring-cloud-loadbalancer</artifactId>
-                </exclusion>
-            </exclusions>
-        </dependency>
-
-<!--        <dependency>-->
-<!--            <groupId>org.springframework.cloud</groupId>-->
-<!--            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>-->
-<!--            <version>${eureka-client.version}</version>-->
-<!--            <exclusions>-->
-<!--                <exclusion>-->
-<!--                    <groupId>org.springframework.cloud</groupId>-->
-<!--                    <artifactId>spring-cloud-starter-loadbalancer</artifactId>-->
-<!--                </exclusion>-->
-<!--            </exclusions>-->
-<!--        </dependency>-->
-
-        <dependency>
-            <groupId>org.springframework.cloud</groupId>
-            <artifactId>spring-cloud-commons</artifactId>
-            <version>${spring-cloud-commons.version}</version>
-        </dependency>
-        <!--shenyu springCloud plugin end-->
-
-        <!--shenyu key-auth plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-key-auth</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu key-auth plugin end -->
-
-        <!--shenyu mock plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-mock</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu mock plugin end-->
-
-        <!--shenyu  apache dubbo plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-apache-dubbo</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>org.apache.dubbo</groupId>
-            <artifactId>dubbo</artifactId>
-            <version>${apache.dubbo.version}</version>
-        </dependency>
-        <!-- Dubbo Nacos registry dependency -->
-        <!--  <dependency>
-              <groupId>org.apache.dubbo</groupId>
-              <artifactId>dubbo-registry-nacos</artifactId>
-              <version>2.7.15</version>
-          </dependency>
-          <dependency>
-              <groupId>com.alibaba.nacos</groupId>
-              <artifactId>nacos-client</artifactId>
-              <version>2.0.4</version>
-          </dependency>-->
-        <!-- Dubbo zookeeper registry dependency start -->
-        <dependency>
-            <groupId>org.apache.dubbo</groupId>
-            <artifactId>dubbo-dependencies-zookeeper</artifactId>
-            <version>${apache.dubbo.version}</version>
-            <exclusions>
-                <exclusion>
-                    <artifactId>slf4j-log4j12</artifactId>
-                    <groupId>org.slf4j</groupId>
-                </exclusion>
-            </exclusions>
-            <type>pom</type>
-        </dependency>
-        <!-- Dubbo zookeeper registry dependency end -->
-        <!-- shenyu  apache dubbo plugin end-->
-
-        <!--shenyu motan plugin start-->
-        <!--If you plan to use the motan plugin and want to use the hessian serialization,
-        please check the sofa plugin related dependencies.In particular, the reliance on sofa-hessian should be excluded.
-        Because sofa-hessian and caucho-hessian can cause class loading conflicts and cause some unexpected problems-->
-        <dependency>
-            <groupId>com.weibo</groupId>
-            <artifactId>motan-core</artifactId>
-            <version>${motan.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>com.weibo</groupId>
-            <artifactId>motan-transport-netty4</artifactId>
-            <version>${motan.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>com.weibo</groupId>
-            <artifactId>motan-registry-zookeeper</artifactId>
-            <version>${motan.version}</version>
-            <exclusions>
-                <exclusion>
-                    <groupId>log4j</groupId>
-                    <artifactId>log4j</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.slf4j</groupId>
-                    <artifactId>slf4j-log4j12</artifactId>
-                </exclusion>
-            </exclusions>
-        </dependency>
-        <dependency>
-            <groupId>com.weibo</groupId>
-            <artifactId>motan-springsupport</artifactId>
-            <version>${motan.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-motan</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu motan plugin end-->
-
-        <!--shenyu data sync start use zookeeper-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-sync-data-zookeeper</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-
-        <!--shenyu data sync start use websocket-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-sync-data-websocket</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-
-        <!--shenyu data sync start use http-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-sync-data-http</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-
-        <!--shenyu data sync start use nacos-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-sync-data-nacos</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-
-        <!--shenyu data sync start use etcd-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-sync-data-etcd</artifactId>
-            <version>${project.version}</version>
-            <exclusions>
-                <exclusion>
-                    <groupId>io.grpc</groupId>
-                    <artifactId>grpc-grpclb</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>io.grpc</groupId>
-                    <artifactId>grpc-netty</artifactId>
-                </exclusion>
-            </exclusions>
-        </dependency>
-        <!--shenyu debug plugin end-->
-
-        <!--shenyu data sync start use consul-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-sync-data-consul</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu registry start-->
-
-        <!--shenyu data sync start use polaris-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-sync-data-polaris</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-
-        <!--shenyu instance start-->
-
-        <!--shenyu registry end-->
-
-        <!--shenyu logging-rocketmq plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-rocketmq</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu logging-rocketmq plugin end-->
-
-        <!--shenyu logging-kafka plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-kafka</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu logging-kafka plugin end-->
-
-        <!--shenyu logging-rabbitmq plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-rabbitmq</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu logging-rabbitmq plugin end-->
-
-        <!--shenyu logging-elasticsearch plugin start-->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-elasticsearch</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!--shenyu logging-elasticsearch plugin end-->
-
-        <!-- shenyu logging-aliyunsls plugin start -->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-aliyun-sls</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu logging-aliyunsls plugin end -->
-
-        <!-- shenyu logging-pulsar plugin start -->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-pulsar</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu logging-pulsar plugin end -->
-
-        <!-- shenyu logging-tencentcls plugin start -->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-tencent-cls</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu logging-tencentcls plugin end -->
-
-        <!-- shenyu logging-huaweilts plugin start -->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-huawei-lts</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu logging-huaweilts plugin end -->
-
+                    <artifactId>spring-cloud-commons</artifactId>
+                    <version>${spring-cloud-commons.version}</version>
+                </dependency>
+            </dependencies>
+        </profile>
 
-        <!-- shenyu logging-clickhouse plugin start -->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-logging-clickhouse</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu logging-clickhouse plugin end -->
+        <!-- Logging Profile: Advanced Logging Plugins -->
+        <profile>
+            <id>logging</id>
+            <dependencies>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-rocketmq</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-kafka</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-rabbitmq</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-elasticsearch</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-aliyun-sls</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-pulsar</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-tencent-cls</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-huawei-lts</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-logging-clickhouse</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+            </dependencies>
+        </profile>
 
-        <!-- shenyu kubernetes controller starter -->
-<!--        <dependency>-->
-<!--            <groupId>org.apache.shenyu</groupId>-->
-<!--            <artifactId>shenyu-spring-boot-starter-k8s</artifactId>-->
-<!--            <version>${project.version}</version>-->
-<!--        </dependency>-->
-        <!-- shenyu kubernetes controller end -->
+        <!-- AI Profile: AI Plugins -->
+        <profile>
+            <id>ai</id>
+            <dependencies>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-ai-proxy</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-ai-prompt</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-ai-token-limiter</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-ai-request-transformer</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-ai-response-transformer</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+            </dependencies>
+        </profile>
 
-        <!-- shenyu basic-auth plugin start -->
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-plugin-basic-auth</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>org.apache.shenyu</groupId>
-            <artifactId>shenyu-spring-boot-starter-client-beat</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <!-- shenyu basic-auth plugin end -->
+        <!-- MCP Profile -->
+        <profile>
+            <id>mcp</id>
+            <dependencies>
+                <dependency>
+                    <groupId>org.apache.shenyu</groupId>
+                    <artifactId>shenyu-spring-boot-starter-plugin-mcp-server</artifactId>
+                    <version>${project.version}</version>
+                </dependency>
+            </dependencies>
+        </profile>
 
-    </dependencies>
-    <profiles>
+        <!-- Release Profile -->
         <profile>
             <id>release</id>
             <build>
@@ -634,6 +496,7 @@
             </build>
         </profile>
     </profiles>
+
     <build>
         <finalName>shenyu-bootstrap</finalName>
         <plugins>

From 9a6cf86804544d571a8b576439b203f6b73004e5 Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Tue, 13 Jan 2026 09:40:43 +0800
Subject: [PATCH 03/16] refactor: centralize dependency versions in parent pom

- Move nacos-discovery.version and eureka-client.version to parent pom properties
- Remove redundant property definitions from shenyu-bootstrap/pom.xml
---
 pom.xml                  | 2 ++
 shenyu-bootstrap/pom.xml | 5 -----
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/pom.xml b/pom.xml
index e510a85d0a3b..a11c4815a469 100644
--- a/pom.xml
+++ b/pom.xml
@@ -189,6 +189,8 @@
         <spring-ai.version>1.0.0</spring-ai.version>
         <mcp.version>0.10.0</mcp.version>
         <swagger-parser.version>2.1.30</swagger-parser.version>
+        <nacos-discovery.version>2021.0.1.0</nacos-discovery.version>
+        <eureka-client.version>4.1.2</eureka-client.version>
         <!-- dependency version end -->
     </properties>
 
diff --git a/shenyu-bootstrap/pom.xml b/shenyu-bootstrap/pom.xml
index 54d24a6cd74e..2e00a2d66c4c 100644
--- a/shenyu-bootstrap/pom.xml
+++ b/shenyu-bootstrap/pom.xml
@@ -25,11 +25,6 @@
     <modelVersion>4.0.0</modelVersion>
     <artifactId>shenyu-bootstrap</artifactId>
 
-    <properties>
-        <nacos-discovery.version>2021.0.1.0</nacos-discovery.version>
-        <eureka-client.version>4.1.2</eureka-client.version>
-    </properties>
-
     <dependencies>
         <!-- Spring Boot Starters -->
         <dependency>

From cfda2748c88662a8d8004010d0cc3e2e8c83bffd Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 14:13:20 +0800
Subject: [PATCH 04/16] refactor: add ShenyuPluginException class and improve
 error handling in ShenyuWebHandler

---
 .vscode/settings.json                         |   3 -
 CODE_SIMPLIFICATION_ANALYSIS.md               | 168 -------------
 PHASE1_COMPLETION_REPORT.md                   | 224 -----------------
 REFACTORING_PLAN.md                           | 226 ------------------
 docs/BOOTSTRAP_PROFILES.md                    |  50 ----
 shenyu-bootstrap/pom.xml                      |   7 +
 .../api/exception/ShenyuPluginException.java  |  56 +++++
 .../sdk/httpclient/HttpShenyuSdkClient.java   |   2 +-
 .../httpclient/HttpShenyuSdkClientTest.java   |   6 +-
 .../shenyu/web/handler/ShenyuWebHandler.java  |  14 +-
 10 files changed, 74 insertions(+), 682 deletions(-)
 delete mode 100644 .vscode/settings.json
 delete mode 100644 CODE_SIMPLIFICATION_ANALYSIS.md
 delete mode 100644 PHASE1_COMPLETION_REPORT.md
 delete mode 100644 REFACTORING_PLAN.md
 delete mode 100644 docs/BOOTSTRAP_PROFILES.md
 create mode 100644 shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/exception/ShenyuPluginException.java

diff --git a/.vscode/settings.json b/.vscode/settings.json
deleted file mode 100644
index 7b016a89fbaf..000000000000
--- a/.vscode/settings.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-    "java.compile.nullAnalysis.mode": "automatic"
-}
\ No newline at end of file
diff --git a/CODE_SIMPLIFICATION_ANALYSIS.md b/CODE_SIMPLIFICATION_ANALYSIS.md
deleted file mode 100644
index 9981e1baa6c2..000000000000
--- a/CODE_SIMPLIFICATION_ANALYSIS.md
+++ /dev/null
@@ -1,168 +0,0 @@
-# Apache Shenyu Code Simplification Analysis Report
-
-## Executive Summary
-
-This report provides a comprehensive analysis of the Apache Shenyu codebase for opportunities to simplify and refine code for clarity, consistency, and maintainability while preserving all functionality. The analysis focuses on key areas including the plugin system, core handlers, configuration management, and recent modifications.
-
-## 1. Plugin System Architecture
-
-### Current State
-The `ShenyuPlugin` interface (`shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java`) serves as the foundation for all plugins in the Shenyu gateway. It provides:
-
-- Core execution method: `execute(ServerWebExchange exchange, ShenyuPluginChain chain)`
-- Ordering mechanism: `getOrder()`
-- Skip logic with multiple overloaded methods
-- Performance monitoring hooks: `before()` and `after()`
-
-### Observations and Recommendations
-
-#### 1.1 Skip Logic Complexity
-The interface contains multiple skip methods:
-- `skip(ServerWebExchange exchange)` - basic skip
-- `skip(ServerWebExchange exchange, RpcTypeEnum... rpcTypes)` - skip based on RPC types
-- `skipExcept(ServerWebExchange exchange, RpcTypeEnum... exceptRpcTypes)` - inverse logic
-- `skipExceptHttpLike(ServerWebExchange exchange)` - HTTP-specific skip
-
-**Recommendation**: Consider consolidating these into a single flexible method or using a builder pattern to reduce API surface area while maintaining functionality.
-
-#### 1.2 Performance Monitoring Overhead
-The current `before()` and `after()` methods in `ShenyuPlugin` interface always log timing information, which may impact performance in high-throughput scenarios.
-
-**Recommendation**:
-- Make logging conditional based on configuration
-- Consider using a more efficient timing mechanism
-- Provide opt-out capability for plugins that don't need timing
-
-## 2. Core Handler Implementation
-
-### ShenyuWebHandler Analysis
-The `ShenyuWebHandler` (`shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`) is the central request handler that orchestrates plugin execution.
-
-### Key Areas for Improvement
-
-#### 2.1 Plugin Management Complexity
-The `putExtPlugins()` method contains complex logic for handling plugin additions and updates:
-
-```java
-// Current implementation has nested streams and multiple iterations
-final List<ShenyuPlugin> shenyuAddPlugins = extPlugins.stream()
-    .filter(e -> plugins.stream().noneMatch(plugin -> plugin.named().equals(e.named())))
-    .collect(Collectors.toList());
-
-final List<ShenyuPlugin> shenyuUpdatePlugins = extPlugins.stream()
-    .filter(e -> plugins.stream().anyMatch(plugin -> plugin.named().equals(e.named())))
-    .collect(Collectors.toList());
-```
-
-**Recommendation**:
-- Use a single pass through the collection instead of multiple stream operations
-- Consider using a Map for O(1) lookups instead of O(n) searches
-- Extract the logic into smaller, more focused methods
-
-#### 2.2 Thread Safety Concerns
-The class uses `volatile List<ShenyuPlugin> plugins` with copy-on-write semantics, but some methods like `onPluginEnabled()` and `onPluginRemoved()` use `synchronized` blocks while others don't.
-
-**Recommendation**:
-- Standardize on a single concurrency strategy
-- Consider using `CopyOnWriteArrayList` for automatic thread safety
-- Ensure consistent synchronization across all mutation methods
-
-#### 2.3 DefaultShenyuPluginChain Recursion
-The `DefaultShenyuPluginChain.execute()` method uses recursion for plugin execution, which could lead to stack overflow in scenarios with many plugins.
-
-**Recommendation**:
-- Convert to iterative approach to avoid potential stack overflow
-- Consider using reactive operators like `Flux.fromIterable().reduce()` for better resource management
-
-## 3. Configuration and Dependency Management
-
-### Bootstrap POM Analysis
-The `shenyu-bootstrap/pom.xml` file includes a comprehensive list of plugin dependencies, many of which are commented out or conditionally included.
-
-### Observations
-
-#### 3.1 Dependency Bloat
-The bootstrap module includes dependencies for all possible plugins, even those that may not be used in a typical deployment.
-
-**Recommendation**:
-- Consider making plugin dependencies optional or using profiles to include only necessary plugins
-- Implement a more modular approach where users can select required plugins
-- Reduce the default footprint of the bootstrap application
-
-#### 3.2 Version Management
-Multiple version properties are defined inline, which can lead to inconsistency.
-
-**Recommendation**:
-- Centralize version management in parent POM or dependency management section
-- Use consistent versioning strategy across all modules
-
-## 4. Recent Modifications Analysis
-
-Based on recent commits, the following areas have been actively modified:
-
-1. **OrderlyExecutor resource leak fix** - Indicates ongoing attention to resource management
-2. **Test coverage improvements** - Good focus on quality
-3. **Header handling bugs** - Shows complexity in HTTP handling logic
-4. **AI proxy module enhancements** - New feature area that may benefit from early refactoring
-
-## 5. Specific Code Quality Issues
-
-### 5.1 Logging Practices
-- Inconsistent logging levels and patterns across the codebase
-- Some logging statements may be too verbose for production use
-- Missing structured logging for better observability
-
-### 5.2 Error Handling
-- Some methods lack proper error handling or validation
-- Exception handling could be more consistent across components
-
-### 5.3 Code Duplication
-- Similar logic appears in multiple places (e.g., plugin sorting, filtering)
-- Opportunity to extract common utilities or base classes
-
-## 6. Recommendations Summary
-
-### High Priority
-1. **Refactor plugin management logic** in `ShenyuWebHandler.putExtPlugins()` to improve performance and readability
-2. **Standardize concurrency handling** across the plugin system
-3. **Convert recursive plugin chain execution** to iterative approach
-4. **Optimize logging overhead** in hot paths
-
-### Medium Priority
-1. **Simplify skip logic** in `ShenyuPlugin` interface
-2. **Reduce bootstrap dependency footprint**
-3. **Improve error handling consistency**
-4. **Extract common utilities** to reduce code duplication
-
-### Low Priority
-1. **Enhance test coverage** for edge cases
-2. **Improve documentation** for plugin development
-3. **Standardize code formatting** across the codebase
-
-## 7. Implementation Strategy
-
-### Phase 1: Core Performance Improvements
-- Focus on high-priority items that impact performance and stability
-- Ensure backward compatibility with existing plugins
-- Add comprehensive tests for refactored components
-
-### Phase 2: API Simplification
-- Gradually simplify the plugin interface while maintaining compatibility
-- Introduce new APIs alongside existing ones for smooth transition
-
-### Phase 3: Code Quality Enhancement
-- Address medium and low priority items
-- Improve overall code maintainability and developer experience
-
-## 8. Risk Assessment
-
-- **Backward Compatibility**: All changes should maintain plugin compatibility
-- **Performance Impact**: Performance improvements should be measured and validated
-- **Testing Coverage**: Ensure adequate test coverage before and after changes
-- **Documentation**: Update documentation to reflect any API changes
-
-## Conclusion
-
-The Apache Shenyu codebase demonstrates solid architecture and design principles. However, there are several opportunities to improve code clarity, performance, and maintainability. By implementing the recommendations outlined in this report, the project can achieve better performance, easier maintenance, and improved developer experience while preserving all existing functionality.
-
-The most critical areas for immediate attention are the plugin management logic in `ShenyuWebHandler` and the recursive plugin chain execution, as these directly impact performance and stability in production environments.
\ No newline at end of file
diff --git a/PHASE1_COMPLETION_REPORT.md b/PHASE1_COMPLETION_REPORT.md
deleted file mode 100644
index f1a1842ae158..000000000000
--- a/PHASE1_COMPLETION_REPORT.md
+++ /dev/null
@@ -1,224 +0,0 @@
-# Phase 1 Completion Report
-
-**Date:** 2026-01-11
-**Status:** ✅ COMPLETED
-**Branch:** feat/refactor
-
-## Executive Summary
-
-Phase 1 of the Enhanced Plugin Architecture refactoring has been successfully completed. All core components have been implemented, tested, and integrated into the ShenYu plugin-base module.
-
-## Deliverables
-
-### Core Components Implemented ✅
-
-1. **RouteResolver** (`DefaultRouteResolver`)
-   - Separated routing logic from plugin execution
-   - Intelligent selector and rule matching
-   - Integrated with SmartCacheManager
-   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/route/`
-
-2. **SmartCacheManager** (`DefaultSmartCacheManager`)
-   - Unified cache management for selectors and rules
-   - Configurable cache capacity and TTL
-   - Thread-safe concurrent implementation
-   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/cache/`
-
-3. **MetricsHelper** (`NoOpMetricsHelper`)
-   - Metrics collection interface
-   - No-op default implementation (ready for extension)
-   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/metrics/`
-
-4. **PluginExecutionContext**
-   - Encapsulates request execution context
-   - Extracts and caches request attributes
-   - Reduces ServerWebExchange dependencies
-   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/context/`
-
-5. **EnhancedAbstractShenyuPlugin**
-   - New plugin base class using enhanced components
-   - Backward compatible with existing plugins
-   - Cleaner separation of concerns
-   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/`
-
-6. **PluginBaseAutoConfiguration**
-   - Spring Boot auto-configuration for enhanced mode
-   - Conditional bean creation based on system property
-   - Configuration logging for debugging
-   - Location: `shenyu-plugin-base/src/main/java/org/apache/shenyu/plugin/base/config/`
-
-### Testing Coverage ✅
-
-**Total Tests:** 167
-**Passed:** 167
-**Failed:** 0
-**Coverage:** > 80% for new components
-
-#### Key Test Classes:
-- `DefaultRouteResolverTest` (13 tests) ✅
-- `DefaultSmartCacheManagerTest` (13 tests) ✅
-- `PluginExecutionContextTest` (11 tests) ✅
-- Plus 32 additional test classes covering existing functionality
-
-### Code Quality Metrics ✅
-
-- **Checkstyle Violations:** 0
-- **Build Status:** SUCCESS
-- **Compilation Errors:** 0
-- **Code Style:** Compliant with Apache ShenYu standards
-
-## Architecture Changes
-
-### Before (Legacy Mode)
-```
-AbstractShenyuPlugin
-  ├── Direct ServerWebExchange manipulation
-  ├── Inline selector/rule matching logic
-  ├── Tightly coupled cache access (BaseDataCache, MatchDataCache)
-  └── No metrics collection
-```
-
-### After (Enhanced Mode)
-```
-AbstractShenyuPlugin / EnhancedAbstractShenyuPlugin
-  ├── RouteResolver (selector/rule matching)
-  ├── PluginExecutionContext (request context)
-  ├── SmartCacheManager (unified caching)
-  └── MetricsHelper (metrics collection)
-```
-
-## Configuration
-
-### Enable Enhanced Mode
-
-**Option 1: System Property**
-```bash
--Dshenyu.plugin.enhanced.enabled=true
-```
-
-**Option 2: application.yml**
-```yaml
-shenyu:
-  plugin:
-    enhanced:
-      enabled: true
-  selectorMatchCache:
-    cache:
-      initialCapacity: 10000
-      maximumSize: 100000
-  ruleMatchCache:
-    cache:
-      initialCapacity: 10000
-      maximumSize: 100000
-```
-
-## Git Commit History
-
-```
-2902830ca docs: add Phase 1 implementation documentation and guides
-d5ba00698 refactor: implement enhanced plugin architecture with conditional components and configuration
-3a1139d35 refactor: enhance code documentation and improve readability across multiple classes
-```
-
-## Documentation Delivered
-
-1. **CLAUDE.md** - Project development guide
-2. **IMPLEMENTATION_BLUEPRINT.md** - Complete implementation plan
-3. **PHASE1_DESIGN.md** - Detailed architecture design
-4. **PHASE1_STARTUP_GUIDE.md** - Startup and validation guide
-5. **GATEWAY_COMPARISON.md** - Gateway comparison analysis
-6. **PERFORMANCE_TEST_RESULTS.md** - Benchmark results
-7. **docs/** directory with additional guides
-
-## Validation Checklist
-
-- [x] All unit tests pass (167/167)
-- [x] Build succeeds without errors
-- [x] Checkstyle validation passes (0 violations)
-- [x] Core components implemented
-- [x] Spring Boot auto-configuration working
-- [x] Backward compatibility maintained
-- [x] Documentation complete
-- [x] Code committed to git
-
-## Next Steps
-
-### Recommended: Phase 2 Planning
-
-Based on the original implementation blueprint, Phase 2 should include:
-
-1. **Migrate Existing Plugins**
-   - Start with divide plugin (HTTP proxy)
-   - Create migration utilities
-   - Establish migration patterns
-
-2. **Performance Benchmarking**
-   - Implement JMH benchmarks
-   - Compare legacy vs enhanced mode
-   - Validate 30% performance improvement target
-
-3. **Production Readiness**
-   - Implement real MetricsHelper (Prometheus integration)
-   - Add observability features
-   - Create migration guides for plugin developers
-
-4. **Integration Testing**
-   - End-to-end tests with real services
-   - Load testing scenarios
-   - Stress testing cache performance
-
-### Alternative: Direct Deployment
-
-If Phase 1 is sufficient for your needs:
-
-1. Push changes to remote repository
-2. Create pull request to master
-3. Deploy to staging environment
-4. Run integration tests
-5. Monitor performance metrics
-
-## Performance Expectations
-
-Based on design goals:
-
-| Metric | Baseline | Phase 1 Target | Status |
-|--------|----------|----------------|--------|
-| Plugin Execution | 5ms | 3.5ms (-30%) | 🟡 Pending benchmark |
-| Cache Hit Ratio | 65% | 85% (+25%) | 🟡 Pending validation |
-| Memory Usage | 512MB | 400MB (-22%) | 🟡 Pending measurement |
-| Throughput (QPS) | 10,000 | 13,000 (+30%) | 🟡 Pending load test |
-
-**Note:** Performance metrics require deployment to test environment with real workloads.
-
-## Risks and Mitigation
-
-### Risk 1: Plugin Compatibility
-- **Risk:** Existing plugins may not work with enhanced mode
-- **Mitigation:** Enhanced mode is opt-in; legacy mode remains default
-- **Status:** ✅ Mitigated
-
-### Risk 2: Configuration Complexity
-- **Risk:** Users may not understand how to enable enhanced mode
-- **Mitigation:** Comprehensive documentation and startup guide provided
-- **Status:** ✅ Mitigated
-
-### Risk 3: Performance Regression
-- **Risk:** New components may introduce overhead
-- **Mitigation:** Benchmarking required before production deployment
-- **Status:** 🟡 Requires Phase 2 validation
-
-## Conclusion
-
-Phase 1 has successfully delivered all planned components with high code quality and test coverage. The enhanced plugin architecture is ready for:
-
-1. ✅ **Local testing** - Can be enabled and tested immediately
-2. 🟡 **Performance validation** - Requires Phase 2 benchmarking
-3. 🟡 **Production deployment** - Requires plugin migration and validation
-
-**Recommendation:** Proceed with Phase 2 to complete performance validation and migrate at least one production plugin (divide plugin) to demonstrate real-world benefits.
-
----
-
-**Prepared by:** Claude Sonnet 4.5
-**Review Status:** Ready for technical review
-**Approval Required:** Yes (before merging to master)
diff --git a/REFACTORING_PLAN.md b/REFACTORING_PLAN.md
deleted file mode 100644
index 31f359f66c50..000000000000
--- a/REFACTORING_PLAN.md
+++ /dev/null
@@ -1,226 +0,0 @@
-# Apache Shenyu 重构计划
-
-## 1. 重构目标
-
-- **性能优化**: 减少高吞吐场景下的性能开销
-- **代码简化**: 降低复杂度，提高可读性和可维护性
-- **架构清晰**: 统一并发策略，消除不一致的设计模式
-- **向后兼容**: 确保所有现有插件和功能正常工作
-- **开发体验**: 改善开发者体验，提供更清晰的API
-
-## 2. 重构阶段规划
-
-### 阶段1: 核心性能改进 (高优先级 - 1-2周)
-
-#### 2.1 Plugin Chain 执行优化
-**问题**: `DefaultShenyuPluginChain.execute()` 使用递归可能导致栈溢出
-**解决方案**: 转换为迭代式执行
-**文件**: `shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`
-**任务**:
-- [ ] 设计迭代式插件执行逻辑
-- [ ] 实现新的 `DefaultShenyuPluginChain`
-- [ ] 添加性能基准测试
-- [ ] 验证向后兼容性
-
-#### 2.2 Plugin Management 重构
-**问题**: `putExtPlugins()` 方法包含复杂的嵌套流操作和多次遍历
-**解决方案**: 单次遍历 + Map查找优化
-**文件**: `shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`
-**任务**:
-- [ ] 使用 HashMap 存储现有插件用于 O(1) 查找
-- [ ] 单次遍历 extPlugins 进行分类处理
-- [ ] 提取独立方法处理添加/更新逻辑
-- [ ] 添加单元测试覆盖边界情况
-
-#### 2.3 并发策略标准化
-**问题**: 混合使用 volatile + synchronized，部分方法缺少同步
-**解决方案**: 统一使用 CopyOnWriteArrayList 或完全同步
-**文件**: `shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java`
-**任务**:
-- [ ] 评估 CopyOnWriteArrayList vs synchronized 方案
-- [ ] 实施选定的并发策略
-- [ ] 移除冗余的 volatile 关键字（如果使用 COW）
-- [ ] 添加并发测试用例
-
-### 阶段2: API 简化与优化 (中优先级 - 2-3周)
-
-#### 2.4 ShenyuPlugin 接口简化
-**问题**: 多个 skip 方法造成 API 膨胀
-**解决方案**: 引入 SkipStrategy 模式或简化方法签名
-**文件**: `shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java`
-**任务**:
-- [ ] 设计统一的 skip 机制
-- [ ] 保持向后兼容的默认实现
-- [ ] 更新所有内置插件使用新API
-- [ ] 更新文档和示例
-
-#### 2.5 日志性能优化
-**问题**: 所有插件强制记录执行时间，影响性能
-**解决方案**: 可配置的日志级别和条件日志记录
-**文件**: `shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java`
-**任务**:
-- [ ] 添加配置属性控制日志详细程度
-- [ ] 实现条件日志记录逻辑
-- [ ] 提供插件级别的日志控制选项
-- [ ] 更新默认配置文件
-
-### 阶段3: 依赖和配置优化 (中优先级 - 1-2周)
-
-#### 2.6 Bootstrap 依赖瘦身
-**问题**: shenyu-bootstrap 包含所有插件依赖，导致包体积过大
-**解决方案**: 使用 Maven profiles 或可选依赖
-**文件**: `shenyu-bootstrap/pom.xml`
-**任务**:
-- [ ] 分析实际使用频率最高的插件
-- [ ] 创建不同的构建 profile（minimal, standard, full）
-- [ ] 更新构建文档和 README
-- [ ] 验证不同 profile 的功能完整性
-
-#### 2.7 版本管理集中化
-**问题**: 版本号分散定义，容易出现不一致
-**解决方案**: 在 parent POM 中集中管理版本
-**文件**: `pom.xml` (parent), `shenyu-bootstrap/pom.xml`
-**任务**:
-- [ ] 将所有版本属性移到 parent POM
-- [ ] 使用 dependencyManagement 统一版本
-- [ ] 清理重复的版本定义
-
-### 阶段4: 代码质量提升 (低优先级 - 持续进行)
-
-#### 2.8 错误处理标准化
-**问题**: 异常处理不一致，缺乏统一模式
-**任务**:
-- [ ] 定义统一的异常处理策略
-- [] 创建自定义异常类型
-- [ ] 在关键路径添加适当的错误处理
-
-#### 2.9 公共工具提取
-**问题**: 相似逻辑在多处重复
-**任务**:
-- [ ] 识别重复代码模式
-- [ ] 提取到公共工具类
-- [ ] 更新现有代码使用工具类
-
-## 3. 技术风险与缓解措施
-
-### 3.1 向后兼容性风险
-**风险**: 插件开发者可能依赖现有行为
-**缓解措施**:
-- 保持所有公共API不变
-- 新功能通过默认方法或配置启用
-- 提供详细的迁移指南
-- 在发布前进行充分的兼容性测试
-
-### 3.2 性能回归风险
-**风险**: 重构可能引入新的性能瓶颈
-**缓解措施**:
-- 建立性能基准测试套件
-- 每个变更都要进行性能验证
-- 使用 A/B 测试对比重构前后性能
-
-### 3.3 并发安全风险
-**风险**: 并发策略变更可能引入竞态条件
-**缓解措施**:
-- 编写全面的并发测试
-- 使用静态分析工具检测潜在问题
-- 在 staging 环境充分测试
-
-## 4. 测试策略
-
-### 4.1 单元测试
-- 覆盖所有重构的边界情况
-- 验证向后兼容性
-- 测试并发场景
-
-### 4.2 集成测试
-- 端到端插件执行流程
-- 多插件组合场景
-- 配置变更场景
-
-### 4.3 性能测试
-- 建立基准性能指标
-- 对比重构前后性能
-- 压力测试高并发场景
-
-### 4.4 兼容性测试
-- 现有插件功能验证
-- 第三方插件兼容性测试
-- 配置文件兼容性验证
-
-## 5. 里程碑计划
-
-### 里程碑1: 核心性能改进完成 (第2周)
-- [ ] Plugin Chain 迭代式执行完成
-- [ ] Plugin Management 优化完成
-- [ ] 并发策略标准化完成
-- [ ] 基准性能测试通过
-
-### 里程碑2: API 简化完成 (第5周)
-- [ ] ShenyuPlugin 接口优化完成
-- [ ] 日志性能优化完成
-- [ ] 所有内置插件适配新API
-
-### 里程碑3: 依赖优化完成 (第7周)
-- [ ] Bootstrap 依赖瘦身完成
-- [ ] 版本管理集中化完成
-- [ ] 多profile构建验证通过
-
-### 里程碑4: 代码质量提升 (持续)
-- [ ] 错误处理标准化
-- [ ] 公共工具提取
-- [ ] 文档更新完成
-
-## 6. 资源需求
-
-### 6.1 人力资源
-- **核心开发者**: 2-3人，负责主要重构工作
-- **测试工程师**: 1人，负责测试用例编写和验证
-- **文档工程师**: 0.5人，负责文档更新
-
-### 6.2 时间估算
-- **总时长**: 7-8周
-- **核心阶段**: 2周
-- **API优化**: 3周
-- **依赖优化**: 2周
-- **缓冲时间**: 1-2周
-
-### 6.3 工具需求
-- **性能测试工具**: JMH, Gatling
-- **静态分析工具**: SonarQube, Checkstyle
-- **并发测试工具**: JCStress
-
-## 7. 成功指标
-
-### 7.1 性能指标
-- Plugin Chain 执行时间减少 10-15%
-- 内存占用减少 5-10%
-- GC 压力降低
-
-### 7.2 代码质量指标
-- 代码复杂度降低 (Cyclomatic Complexity)
-- 重复代码减少 20%+
-- 测试覆盖率提升至 85%+
-
-### 7.3 开发体验指标
-- 构建时间减少 (通过依赖瘦身)
-- 新插件开发时间缩短
-- 文档完整性提升
-
-## 8. 回滚策略
-
-如果重构过程中发现严重问题：
-1. **立即停止**当前阶段的开发
-2. **回滚到上一个稳定版本**
-3. **分析根本原因**并制定修复方案
-4. **重新评估**重构策略
-5. **小步快跑**重新开始，每次只做最小可行变更
-
-## 9. 沟通计划
-
-- **每日站会**: 同步进展和阻塞问题
-- **每周评审**: 展示本周成果，规划下周工作
-- **社区公告**: 重大变更提前通知社区
-- **文档更新**: 实时更新重构进展和API变更
-
----
-*本重构计划基于对 Apache Shenyu 代码库的深入分析，旨在在保证稳定性的前提下，显著提升代码质量和性能表现。*
\ No newline at end of file
diff --git a/docs/BOOTSTRAP_PROFILES.md b/docs/BOOTSTRAP_PROFILES.md
deleted file mode 100644
index 57dcec5e0178..000000000000
--- a/docs/BOOTSTRAP_PROFILES.md
+++ /dev/null
@@ -1,50 +0,0 @@
-# ShenYu Bootstrap Build Profiles
-
-This document describes the Maven profiles available for building `shenyu-bootstrap`.
-
-## Overview
-
-To optimize startup time and package size, `shenyu-bootstrap` dependencies have been modularized into Maven profiles. You can choose which set of plugins to include in your build.
-
-## Profiles
-
-| Profile ID | Description | Included Components | Activation |
-|------------|-------------|---------------------|------------|
-| `standard` | **Default**. Common Gateway features. | RateLimiter, Resilience4j, WAF, Sign, JWT, OAuth2, Metrics, WebSocket, all Data Sync methods. | **Active by default** |
-| `minimal` | Core Gateway only. | Param-mapping, Request/Response transformation, Context-path, Cryptor. | Use `-P !standard` |
-| `rpc` | RPC support. | Apache Dubbo, Sofa, Motan, Tars, gRPC, TCP. | Manual (`-P rpc`) |
-| `logging` | Advanced logging. | RocketMQ, Kafka, RabbitMQ, Elasticsearch, Pulsar, ClickHouse, etc. | Manual (`-P logging`) |
-| `ai` | AI Proxy support. | AI Proxy, AI Prompt, Token Limiter, Transformers. | Manual (`-P ai`) |
-| `mcp` | Model Context Protocol. | MCP Server plugin. | Manual (`-P mcp`) |
-
-## Usage Examples
-
-### 1. Build Standard Version (Default)
-Includes common plugins and all data sync options.
-```bash
-mvn clean package -pl shenyu-bootstrap -am
-```
-
-### 2. Build Minimal Version
-Only the core gateway runtime. Useful for lightweight sidecars or simple proxies.
-```bash
-mvn clean package -pl shenyu-bootstrap -am -P !standard
-```
-
-### 3. Build with RPC Support
-Standard features + Dubbo, Sofa, etc.
-```bash
-mvn clean package -pl shenyu-bootstrap -am -P rpc
-```
-
-### 4. Build Full Version (All Features)
-```bash
-mvn clean package -pl shenyu-bootstrap -am -P rpc,logging,ai,mcp
-```
-(Note: `standard` is included by default, so you don't need to list it unless you disabled it)
-
-### 5. Custom Combination
-Example: Minimal core + Dubbo + Kafka Logging
-```bash
-mvn clean package -pl shenyu-bootstrap -am -P !standard,rpc,logging
-```
diff --git a/shenyu-bootstrap/pom.xml b/shenyu-bootstrap/pom.xml
index 2e00a2d66c4c..58d57a34cfe2 100644
--- a/shenyu-bootstrap/pom.xml
+++ b/shenyu-bootstrap/pom.xml
@@ -499,6 +499,13 @@
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <version>${spring-boot.version}</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
             </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/exception/ShenyuPluginException.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/exception/ShenyuPluginException.java
new file mode 100644
index 000000000000..00e0b6a974a1
--- /dev/null
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/exception/ShenyuPluginException.java
@@ -0,0 +1,56 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.shenyu.plugin.api.exception;
+
+import org.apache.shenyu.common.exception.ShenyuException;
+
+/**
+ * Shenyu Plugin Exception.
+ */
+public class ShenyuPluginException extends ShenyuException {
+
+    private static final long serialVersionUID = -2863640033626778462L;
+
+    /**
+     * Instantiates a new Shenyu plugin exception.
+     *
+     * @param e the e
+     */
+    public ShenyuPluginException(final Throwable e) {
+        super(e);
+    }
+
+    /**
+     * Instantiates a new Shenyu plugin exception.
+     *
+     * @param message the message
+     */
+    public ShenyuPluginException(final String message) {
+        super(message);
+    }
+
+    /**
+     * Instantiates a new Shenyu plugin exception.
+     *
+     * @param message   the message
+     * @param throwable the throwable
+     */
+    public ShenyuPluginException(final String message, final Throwable throwable) {
+        super(message, throwable);
+    }
+}
diff --git a/shenyu-sdk/shenyu-sdk-httpclient/src/main/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClient.java b/shenyu-sdk/shenyu-sdk-httpclient/src/main/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClient.java
index 17125d305e18..65148baeaaf6 100644
--- a/shenyu-sdk/shenyu-sdk-httpclient/src/main/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClient.java
+++ b/shenyu-sdk/shenyu-sdk-httpclient/src/main/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClient.java
@@ -76,7 +76,7 @@ protected void initClient(final Properties props) {
             final String maxPerRoute = props.getProperty("http.maxPerRoute", "200");
             final String serverRequestTimeOut = props.getProperty("http.serverRequestTimeOut", "2000");
             final String serverResponseTimeOut = props.getProperty("http.serverResponseTimeOut", "2000");
-            final String connectionRequestTimeOut = props.getProperty("http.connectionRequestTimeOut ", "2000");
+            final String connectionRequestTimeOut = props.getProperty("http.connectionRequestTimeOut", "2000");
             Registry<SchemeIOSessionStrategy> sessionStrategyRegistry = RegistryBuilder.<SchemeIOSessionStrategy>create()
                     .register("https", SSLIOSessionStrategy.getDefaultStrategy())
                     .register("http", NoopIOSessionStrategy.INSTANCE)
diff --git a/shenyu-sdk/shenyu-sdk-httpclient/src/test/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClientTest.java b/shenyu-sdk/shenyu-sdk-httpclient/src/test/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClientTest.java
index a77e194adf7e..52aa9c6c5cfd 100644
--- a/shenyu-sdk/shenyu-sdk-httpclient/src/test/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClientTest.java
+++ b/shenyu-sdk/shenyu-sdk-httpclient/src/test/java/org/apache/shenyu/sdk/httpclient/HttpShenyuSdkClientTest.java
@@ -35,8 +35,12 @@ public class HttpShenyuSdkClientTest {
 
     @Test
     public void testShenyuHttpClient() throws IOException {
+        Properties props = new Properties();
+        props.setProperty("http.connectionRequestTimeOut", "10000");
+        props.setProperty("http.serverRequestTimeOut", "10000");
+        props.setProperty("http.serverResponseTimeOut", "10000");
         HttpShenyuSdkClient shenyuHttpClient = mock(HttpShenyuSdkClient.class, Mockito.CALLS_REAL_METHODS);
-        shenyuHttpClient.initClient(new Properties());
+        shenyuHttpClient.initClient(props);
         Map<String, Collection<String>> headerMap = new HashMap<>();
         headerMap.put("header", Arrays.asList("test1", "test2"));
         ShenyuRequest shenyuRequest = ShenyuRequest.create(ShenyuRequest.HttpMethod.GET, "https://shenyu.apache.org",
diff --git a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
index b7a4b1e57fbb..cddc018bb7ad 100644
--- a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
+++ b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
@@ -128,16 +128,12 @@ public void after(final ServerWebExchange exchange) {
      */
     @Override
     public Mono<Void> handle(@NonNull final ServerWebExchange exchange) {
-        try {
+        return Mono.defer(() -> {
             before(exchange);
-            Mono<Void> execute = new DefaultShenyuPluginChain(plugins).execute(exchange);
-            if (scheduled) {
-                return execute.subscribeOn(scheduler);
-            }
-            return execute;
-        } finally {
-            after(exchange);
-        }
+            return new DefaultShenyuPluginChain(plugins).execute(exchange);
+        }).doOnError(Throwable.class, e -> LOG.error("shenyu execute plugin exception: ", e))
+          .doFinally(signalType -> after(exchange))
+          .subscribeOn(scheduled ? scheduler : Schedulers.immediate());
     }
     
     /**

From 036775548f4b8fd0a386c4e7c35516101f92d997 Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 15:30:01 +0800
Subject: [PATCH 05/16] refactor: add classifier configuration to repackage
 goal in pom.xml

---
 shenyu-bootstrap/pom.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/shenyu-bootstrap/pom.xml b/shenyu-bootstrap/pom.xml
index 58d57a34cfe2..a256e1f2182c 100644
--- a/shenyu-bootstrap/pom.xml
+++ b/shenyu-bootstrap/pom.xml
@@ -504,6 +504,9 @@
                         <goals>
                             <goal>repackage</goal>
                         </goals>
+                        <configuration>
+                            <classifier>exec</classifier>
+                        </configuration>
                     </execution>
                 </executions>
             </plugin>

From 652c8b523d2cd5d4efcc0f0738b8974a19f139ef Mon Sep 17 00:00:00 2001
From: aias00 <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 18:16:57 +0800
Subject: [PATCH 06/16] Update
 shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .../java/org/apache/shenyu/web/handler/ShenyuWebHandler.java   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
index cddc018bb7ad..b77f14e752f4 100644
--- a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
+++ b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
@@ -56,7 +56,8 @@ public final class ShenyuWebHandler implements WebHandler, ApplicationListener<P
     private static final Logger LOG = LoggerFactory.getLogger(ShenyuWebHandler.class);
 
     /**
-     * this field uses volatile List for thread-safe operations.
+     * Volatile reference to the current plugins list to ensure visibility across threads.
+     * Thread safety of list updates is provided by the surrounding update logic, not by volatile alone.
      */
     private volatile List<ShenyuPlugin> plugins;
 

From d7ecb79ba925146d6b9ff478ac80e9f6bc96aa04 Mon Sep 17 00:00:00 2001
From: aias00 <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 18:17:06 +0800
Subject: [PATCH 07/16] Update
 shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .../java/org/apache/shenyu/plugin/api/ShenyuPlugin.java     | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
index bd50500c5558..69f429c730da 100644
--- a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
@@ -143,7 +143,11 @@ default void after(ServerWebExchange exchange) {
             return;
         }
         long currentTimeMillis = System.currentTimeMillis();
-        long startTime = (long) exchange.getAttributes().get(Constants.PLUGIN_START_TIME + named());
+        Long startTime = exchange.getAttribute(Constants.PLUGIN_START_TIME + named());
+        if (startTime == null) {
+            exchange.getAttributes().remove(Constants.PLUGIN_START_TIME + named());
+            return;
+        }
         long cost = currentTimeMillis - startTime;
         Long minCost = exchange.getAttributeOrDefault(Constants.LOGGING_MIN_COST, 0L);
         if (cost >= minCost) {

From 5161fc9a0aa579019e82f6d8ecfb3e6daa08ec56 Mon Sep 17 00:00:00 2001
From: aias00 <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 18:17:13 +0800
Subject: [PATCH 08/16] Update
 shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .../main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
index 69f429c730da..28fe9e5fd5f2 100644
--- a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
@@ -117,7 +117,7 @@ default boolean skipExcept(ServerWebExchange exchange, RpcTypeEnum... exceptRpcT
      * if return true this plugin can not execute.
      *
      * @param exchange the current server exchange
-     * @return http/spring cloud return true, others false.
+     * @return http/spring cloud/ai return false (not skipped), others return true (skipped).
      */
     default boolean skipExceptHttpLike(ServerWebExchange exchange) {
         return PluginSkipHelper.skipExceptHttpLike(exchange);

From 00a93c27dd023b2783a0d2cfd93a0749b6e9a4eb Mon Sep 17 00:00:00 2001
From: aias00 <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 18:17:19 +0800
Subject: [PATCH 09/16] Update
 shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .../main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
index 28fe9e5fd5f2..968eceac4ec1 100644
--- a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
@@ -151,7 +151,7 @@ default void after(ServerWebExchange exchange) {
         long cost = currentTimeMillis - startTime;
         Long minCost = exchange.getAttributeOrDefault(Constants.LOGGING_MIN_COST, 0L);
         if (cost >= minCost) {
-            LOG.info("shenyu traceId:{}, plugin named:{}, cost:{}", exchange.getLogPrefix(), named(), cost);
+            LOG.debug("shenyu traceId:{}, plugin named:{}, cost:{}", exchange.getLogPrefix(), named(), cost);
         }
         exchange.getAttributes().remove(Constants.PLUGIN_START_TIME + named());
     }

From 7dd845fb8f5525985e71dfb5c860cd267a4129b5 Mon Sep 17 00:00:00 2001
From: aias00 <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 18:17:30 +0800
Subject: [PATCH 10/16] Update
 shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .../org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java
index ba1f86c0b6a4..90b3367bff1e 100644
--- a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/utils/PluginSkipHelper.java
@@ -84,7 +84,7 @@ public static boolean skipExcept(final ServerWebExchange exchange, final RpcType
      * if return true this plugin can not execute.
      *
      * @param exchange the current server exchange
-     * @return http/spring cloud return true, others false.
+     * @return http/spring cloud/ai return false (not skipped), others return true (skipped).
      */
     public static boolean skipExceptHttpLike(final ServerWebExchange exchange) {
         return !skip(exchange, RpcTypeEnum.HTTP, RpcTypeEnum.SPRING_CLOUD, RpcTypeEnum.AI);

From e308b3bcc93db2dc5ff6c6f2074f64a8c498331f Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Wed, 14 Jan 2026 19:22:17 +0800
Subject: [PATCH 11/16] refactor: use Objects.isNull for null check in
 ShenyuPlugin

---
 .../main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
index 968eceac4ec1..cff2a12897ea 100644
--- a/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
+++ b/shenyu-plugin/shenyu-plugin-api/src/main/java/org/apache/shenyu/plugin/api/ShenyuPlugin.java
@@ -17,6 +17,7 @@
 
 package org.apache.shenyu.plugin.api;
 
+import java.util.Objects;
 import org.apache.shenyu.common.constant.Constants;
 import org.apache.shenyu.common.enums.RpcTypeEnum;
 import org.apache.shenyu.plugin.api.utils.PluginSkipHelper;
@@ -144,7 +145,7 @@ default void after(ServerWebExchange exchange) {
         }
         long currentTimeMillis = System.currentTimeMillis();
         Long startTime = exchange.getAttribute(Constants.PLUGIN_START_TIME + named());
-        if (startTime == null) {
+        if (Objects.isNull(startTime)) {
             exchange.getAttributes().remove(Constants.PLUGIN_START_TIME + named());
             return;
         }

From 12774f99bf99d02fe3a3f5e0eda59f1dc82fd803 Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Thu, 15 Jan 2026 09:38:51 +0800
Subject: [PATCH 12/16] refactor: add new plugin types for AI and
 authentication in Plugin.java

---
 .../main/java/org/apache/shenyu/e2e/model/Plugin.java    | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/shenyu-e2e/shenyu-e2e-common/src/main/java/org/apache/shenyu/e2e/model/Plugin.java b/shenyu-e2e/shenyu-e2e-common/src/main/java/org/apache/shenyu/e2e/model/Plugin.java
index 991748bd4f4d..bea03015f2ca 100644
--- a/shenyu-e2e/shenyu-e2e-common/src/main/java/org/apache/shenyu/e2e/model/Plugin.java
+++ b/shenyu-e2e/shenyu-e2e-common/src/main/java/org/apache/shenyu/e2e/model/Plugin.java
@@ -71,9 +71,16 @@ public enum Plugin {
     LOGGING_TENCENT_CLS("loggingTencentCls", 36),
     LOGGING_PULSAR("loggingPulsar", 35),
     LOGGING_CLICK_HOUSE("loggingClickHouse", 38),
+    CASDOOR("casdoor", 39),
+    KEY_AUTH("keyAuth", 40),
     BRPC("brpc", 41),
     LOGGINGHUAWEILTS("loggingHuaweiLts", 43),
-    LOGGINGRABBITMQ("loggingRabbitMQ", 45),;
+    BASIC_AUTH("basicAuth", 44),
+    LOGGINGRABBITMQ("loggingRabbitMQ", 45),
+    AI_TOKEN_LIMITER("aiTokenLimiter", 51),
+    AI_PROMPT("aiPrompt", 52),
+    AI_REQUEST_TRANSFORMER("aiRequestTransformer", 53),
+    AI_RESPONSE_TRANSFORMER("aiResponseTransformer", 66),;
 
     private static final Logger log = LoggerFactory.getLogger(Plugin.class);
     private final String id;

From 6fb7cc5318dd2c8cccf0e13a373c0d9674b6037a Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Thu, 15 Jan 2026 16:23:52 +0800
Subject: [PATCH 13/16] refactor: improve code readability and thread safety in
 ShenyuWebHandler

---
 .../shenyu/web/handler/ShenyuWebHandler.java  | 64 +++++++++----------
 1 file changed, 31 insertions(+), 33 deletions(-)

diff --git a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
index b77f14e752f4..095d4eaabb00 100644
--- a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
+++ b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
@@ -56,15 +56,21 @@ public final class ShenyuWebHandler implements WebHandler, ApplicationListener<P
     private static final Logger LOG = LoggerFactory.getLogger(ShenyuWebHandler.class);
 
     /**
-     * Volatile reference to the current plugins list to ensure visibility across threads.
-     * Thread safety of list updates is provided by the surrounding update logic, not by volatile alone.
+     * Volatile reference to the current plugins list to ensure visibility across
+     * threads.
+     * Thread safety of list updates is provided by the surrounding update logic,
+     * not by volatile alone.
      */
     private volatile List<ShenyuPlugin> plugins;
 
     /**
-     * source plugins, these plugins load from ShenyuPlugin, this filed can't change.
+     * Volatile reference to the source plugins list to ensure visibility across
+     * threads.
+     * These plugins are loaded from ShenyuPlugin. Thread safety of list updates is
+     * provided
+     * by the surrounding update logic using copy-on-write pattern.
      */
-    private final List<ShenyuPlugin> sourcePlugins;
+    private volatile List<ShenyuPlugin> sourcePlugins;
 
     private final ShenyuLoaderService shenyuLoaderService;
 
@@ -77,11 +83,12 @@ public final class ShenyuWebHandler implements WebHandler, ApplicationListener<P
     /**
      * Instantiates a new shenyu web handler.
      *
-     * @param plugins the plugins
+     * @param plugins             the plugins
      * @param shenyuLoaderService shenyuLoaderService
-     * @param shenyuConfig plugins config
+     * @param shenyuConfig        plugins config
      */
-    public ShenyuWebHandler(final List<ShenyuPlugin> plugins, final ShenyuLoaderService shenyuLoaderService, final ShenyuConfig shenyuConfig) {
+    public ShenyuWebHandler(final List<ShenyuPlugin> plugins, final ShenyuLoaderService shenyuLoaderService,
+            final ShenyuConfig shenyuConfig) {
         this.sourcePlugins = new ArrayList<>(plugins);
         this.plugins = new ArrayList<>(plugins);
         this.shenyuLoaderService = shenyuLoaderService;
@@ -117,7 +124,8 @@ public void after(final ServerWebExchange exchange) {
         Map<String, Object> attributes = exchange.getAttributes();
         long currentTimeMillis = System.currentTimeMillis();
         long startTime = (long) attributes.get(Constants.CHAIN_START_TIME);
-        LOG.debug("shenyu chain handle uri:{}, traceId:{}, cost:{}", exchange.getRequest().getPath(), exchange.getLogPrefix(), currentTimeMillis - startTime);
+        LOG.debug("shenyu chain handle uri:{}, traceId:{}, cost:{}", exchange.getRequest().getPath(),
+                exchange.getLogPrefix(), currentTimeMillis - startTime);
         attributes.remove(Constants.CHAIN_START_TIME);
     }
 
@@ -133,10 +141,10 @@ public Mono<Void> handle(@NonNull final ServerWebExchange exchange) {
             before(exchange);
             return new DefaultShenyuPluginChain(plugins).execute(exchange);
         }).doOnError(Throwable.class, e -> LOG.error("shenyu execute plugin exception: ", e))
-          .doFinally(signalType -> after(exchange))
-          .subscribeOn(scheduled ? scheduler : Schedulers.immediate());
+                .doFinally(signalType -> after(exchange))
+                .subscribeOn(scheduled ? scheduler : Schedulers.immediate());
     }
-    
+
     /**
      * Gets plugins.
      *
@@ -145,7 +153,7 @@ public Mono<Void> handle(@NonNull final ServerWebExchange exchange) {
     public List<ShenyuPlugin> getPlugins() {
         return plugins;
     }
-    
+
     /**
      * Put ext plugins.
      *
@@ -156,8 +164,9 @@ public synchronized void putExtPlugins(final List<ShenyuPlugin> extPlugins) {
             return;
         }
 
-        // Copy-on-write: create new list based on current volatile list
+        // Copy-on-write: create new lists based on current volatile lists
         List<ShenyuPlugin> newPlugins = new ArrayList<>(this.plugins);
+        List<ShenyuPlugin> newSourcePlugins = new ArrayList<>(this.sourcePlugins);
 
         // Create a map of existing plugins for O(1) lookup
         Map<String, ShenyuPlugin> existingPluginMap = newPlugins.stream()
@@ -172,13 +181,13 @@ public synchronized void putExtPlugins(final List<ShenyuPlugin> extPlugins) {
             if (existingPluginMap.containsKey(pluginName)) {
                 // Update existing plugin
                 updatePluginInList(extPlugin, newPlugins);
-                updatePluginInSource(extPlugin);
+                updatePluginInList(extPlugin, newSourcePlugins);
                 hasUpdates = true;
                 LOG.info("shenyu auto update extends plugins:{}", pluginName);
             } else {
                 // Add new plugin
                 newPlugins.add(extPlugin);
-                this.sourcePlugins.add(extPlugin);
+                newSourcePlugins.add(extPlugin);
                 hasAdditions = true;
                 LOG.info("shenyu auto add extends plugins:{}", pluginName);
             }
@@ -187,7 +196,8 @@ public synchronized void putExtPlugins(final List<ShenyuPlugin> extPlugins) {
         if (hasAdditions || hasUpdates) {
             // Re-sort the plugins list
             List<ShenyuPlugin> sortedPlugins = sortPlugins(newPlugins);
-            // Volatile write
+            // Volatile writes - atomic reference updates
+            this.sourcePlugins = newSourcePlugins;
             this.plugins = sortedPlugins;
         }
     }
@@ -196,7 +206,7 @@ public synchronized void putExtPlugins(final List<ShenyuPlugin> extPlugins) {
      * Update plugin in the given plugin list.
      *
      * @param updatePlugin the plugin to update
-     * @param pluginList the plugin list to update
+     * @param pluginList   the plugin list to update
      */
     private void updatePluginInList(final ShenyuPlugin updatePlugin, final List<ShenyuPlugin> pluginList) {
         for (int i = 0; i < pluginList.size(); i++) {
@@ -207,20 +217,6 @@ private void updatePluginInList(final ShenyuPlugin updatePlugin, final List<Shen
         }
     }
 
-    /**
-     * Update plugin in the source plugins list.
-     *
-     * @param updatePlugin the plugin to update
-     */
-    private void updatePluginInSource(final ShenyuPlugin updatePlugin) {
-        for (int i = 0; i < this.sourcePlugins.size(); i++) {
-            if (this.sourcePlugins.get(i).named().equals(updatePlugin.named())) {
-                this.sourcePlugins.set(i, updatePlugin);
-                break;
-            }
-        }
-    }
-
     /**
      * listen plugin handler event and handle plugin.
      *
@@ -278,8 +274,10 @@ private void onPluginEnabled(final PluginData pluginData) {
             LOG.info("shenyu start load plugin [{}] from upload plugin jar", pluginData.getName());
             shenyuLoaderService.loadExtOrUploadPlugins(pluginData);
         }
-        final List<ShenyuPlugin> enabledPlugins = this.sourcePlugins.stream().filter(plugin -> plugin.named().equals(pluginData.getName())
-                && pluginData.getEnabled()).collect(Collectors.toList());
+        final List<ShenyuPlugin> enabledPlugins = this.sourcePlugins.stream()
+                .filter(plugin -> plugin.named().equals(pluginData.getName())
+                        && pluginData.getEnabled())
+                .collect(Collectors.toList());
 
         // Copy-on-write
         List<ShenyuPlugin> newPlugins = new ArrayList<>(this.plugins);

From edc66cc9a26c64079264bb60b57953c2b4f0a228 Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Fri, 16 Jan 2026 11:16:51 +0800
Subject: [PATCH 14/16] refactor: improve code formatting and readability in
 test classes

---
 .../service/UpstreamCheckServiceTest.java     | 60 ++++++++++++-------
 .../PolarisSyncDataConfigurationTest.java     | 21 +++----
 2 files changed, 48 insertions(+), 33 deletions(-)

diff --git a/shenyu-admin/src/test/java/org/apache/shenyu/admin/service/UpstreamCheckServiceTest.java b/shenyu-admin/src/test/java/org/apache/shenyu/admin/service/UpstreamCheckServiceTest.java
index 04de27492300..3dc679271c1e 100644
--- a/shenyu-admin/src/test/java/org/apache/shenyu/admin/service/UpstreamCheckServiceTest.java
+++ b/shenyu-admin/src/test/java/org/apache/shenyu/admin/service/UpstreamCheckServiceTest.java
@@ -105,7 +105,7 @@ public final class UpstreamCheckServiceTest {
     private SelectorConditionMapper selectorConditionMapper;
 
     private SelectorHandleConverterFactor converterFactor;
-    
+
     @Mock
     private DiscoveryUpstreamService discoveryUpstreamService;
 
@@ -119,7 +119,8 @@ public final class UpstreamCheckServiceTest {
     public static void beforeClass() {
         loggerSpy = spy(LoggerFactory.getLogger(UpstreamCheckService.class));
         loggerFactoryMockedStatic = mockStatic(LoggerFactory.class);
-        loggerFactoryMockedStatic.when(() -> LoggerFactory.getLogger(UpstreamCheckService.class)).thenReturn(loggerSpy);
+        loggerFactoryMockedStatic.when(() -> LoggerFactory.getLogger(UpstreamCheckService.class))
+                .thenReturn(loggerSpy);
         loggerFactoryMockedStatic.when(() -> LoggerFactory.getLogger(anyString())).thenReturn(loggerSpy);
     }
 
@@ -133,12 +134,17 @@ public void setUp() {
         shenyuRegisterCenterConfig.setRegisterType("http");
         shenyuRegisterCenterConfig.getProps().setProperty(Constants.IS_CHECKED, "true");
         // get static variable reference by reflection
-        upstreamMap = (Map<String, List<DivideUpstream>>) ReflectionTestUtils.getField(UpstreamCheckService.class, "UPSTREAM_MAP");
-        zombieSet = (Set<ZombieUpstream>) ReflectionTestUtils.getField(UpstreamCheckService.class, "ZOMBIE_SET");
+        upstreamMap = (Map<String, List<DivideUpstream>>) ReflectionTestUtils
+                .getField(UpstreamCheckService.class, "UPSTREAM_MAP");
+        upstreamMap.clear();
+        zombieSet = (Set<ZombieUpstream>) ReflectionTestUtils.getField(UpstreamCheckService.class,
+                "ZOMBIE_SET");
+        zombieSet.clear();
         Map<String, SelectorHandleConverter> maps = new HashMap<>();
         maps.put(PluginEnum.DIVIDE.getName(), new DivideSelectorHandleConverter());
         converterFactor = new SelectorHandleConverterFactor(maps);
-        upstreamCheckService = new UpstreamCheckService(selectorMapper, eventPublisher, pluginMapper, selectorConditionMapper,
+        upstreamCheckService = new UpstreamCheckService(selectorMapper, eventPublisher, pluginMapper,
+                selectorConditionMapper,
                 shenyuRegisterCenterConfig, converterFactor, discoveryUpstreamService);
     }
 
@@ -186,20 +192,24 @@ public void testRemoveByKey() {
 
     @Test
     public void testSubmit() {
-        ScheduledThreadPoolExecutor executor = new ScheduledThreadPoolExecutor(1, ShenyuThreadFactory.create("scheduled-upstream-task", false));
-        ReflectionTestUtils.setField(upstreamCheckService, "executor", executor);
-        final DivideUpstream divideUpstream = DivideUpstream.builder()
-                .upstreamUrl("divide-upstream-60")
-                .weight(60)
-                .build();
-        // Test submit when selector name not exists
-        testSubmitOnce(divideUpstream);
-        // Test submit when selector name exists
-        testSubmitOnce(divideUpstream);
-        // Test service deleted
-        divideUpstream.setStatus(false);
-        testSubmitDeleted(divideUpstream);
-        testSubmitDeleted(divideUpstream);
+        try (MockedStatic<UpstreamCheckUtils> mocked = mockStatic(UpstreamCheckUtils.class)) {
+            mocked.when(() -> UpstreamCheckUtils.checkUrl(anyString())).thenReturn(true);
+            ScheduledThreadPoolExecutor executor = new ScheduledThreadPoolExecutor(1,
+                    ShenyuThreadFactory.create("scheduled-upstream-task", false));
+            ReflectionTestUtils.setField(upstreamCheckService, "executor", executor);
+            final DivideUpstream divideUpstream = DivideUpstream.builder()
+                    .upstreamUrl("divide-upstream-60")
+                    .weight(60)
+                    .build();
+            // Test submit when selector name not exists
+            testSubmitOnce(divideUpstream);
+            // Test submit when selector name exists
+            testSubmitOnce(divideUpstream);
+            // Test service deleted
+            divideUpstream.setStatus(false);
+            testSubmitDeleted(divideUpstream);
+            testSubmitDeleted(divideUpstream);
+        }
     }
 
     private void testSubmitOnce(final DivideUpstream divideUpstream) {
@@ -214,7 +224,8 @@ private void testSubmitDeleted(final DivideUpstream divideUpstream) {
 
     @Test
     public void testReplace() {
-        ScheduledThreadPoolExecutor executor = new ScheduledThreadPoolExecutor(1, ShenyuThreadFactory.create("scheduled-upstream-task", false));
+        ScheduledThreadPoolExecutor executor = new ScheduledThreadPoolExecutor(1,
+                ShenyuThreadFactory.create("scheduled-upstream-task", false));
         ReflectionTestUtils.setField(upstreamCheckService, "executor", executor);
         final DivideUpstream divideUpstream = DivideUpstream.builder()
                 .upstreamHost("localhost")
@@ -257,8 +268,10 @@ public void testFetchUpstreamData() {
                 .status(0)
                 .build();
         when(pluginMapper.selectByNames(anyList())).thenReturn(Lists.newArrayList(pluginDO));
-        when(selectorMapper.findByPluginIds(anyList())).thenReturn(Lists.newArrayList(selectorDOWithUrlError, selectorDOWithUrlReachable));
-        when(discoveryUpstreamService.findBySelectorId(anyString())).thenReturn(Lists.newArrayList(discoveryUpstreamData));
+        when(selectorMapper.findByPluginIds(anyList()))
+                .thenReturn(Lists.newArrayList(selectorDOWithUrlError, selectorDOWithUrlReachable));
+        when(discoveryUpstreamService.findBySelectorId(anyString()))
+                .thenReturn(Lists.newArrayList(discoveryUpstreamData));
         upstreamCheckService.fetchUpstreamData();
         assertTrue(upstreamMap.containsKey(MOCK_SELECTOR_NAME));
         assertEquals(2, upstreamMap.get(MOCK_SELECTOR_NAME).size());
@@ -271,7 +284,8 @@ public void testClose() {
         Properties properties = new Properties();
         properties.setProperty(Constants.IS_CHECKED, "true");
         shenyuRegisterCenterConfig.setProps(properties);
-        upstreamCheckService = new UpstreamCheckService(selectorMapper, eventPublisher, pluginMapper, selectorConditionMapper,
+        upstreamCheckService = new UpstreamCheckService(selectorMapper, eventPublisher, pluginMapper,
+                selectorConditionMapper,
                 shenyuRegisterCenterConfig, converterFactor, discoveryUpstreamService);
         upstreamCheckService.close();
     }
diff --git a/shenyu-spring-boot-starter/shenyu-spring-boot-starter-sync-data-center/shenyu-spring-boot-starter-sync-data-polaris/src/test/java/org/apache/shenyu/springboot/stater/sync/data/polaris/PolarisSyncDataConfigurationTest.java b/shenyu-spring-boot-starter/shenyu-spring-boot-starter-sync-data-center/shenyu-spring-boot-starter-sync-data-polaris/src/test/java/org/apache/shenyu/springboot/stater/sync/data/polaris/PolarisSyncDataConfigurationTest.java
index a94151fce5f3..14fe4680b546 100644
--- a/shenyu-spring-boot-starter/shenyu-spring-boot-starter-sync-data-center/shenyu-spring-boot-starter-sync-data-polaris/src/test/java/org/apache/shenyu/springboot/stater/sync/data/polaris/PolarisSyncDataConfigurationTest.java
+++ b/shenyu-spring-boot-starter/shenyu-spring-boot-starter-sync-data-center/shenyu-spring-boot-starter-sync-data-polaris/src/test/java/org/apache/shenyu/springboot/stater/sync/data/polaris/PolarisSyncDataConfigurationTest.java
@@ -43,20 +43,18 @@
  * The test case for {@link PolarisSyncDataConfiguration}.
  */
 @ExtendWith(SpringExtension.class)
-@SpringBootTest(
-        classes = PolarisSyncDataConfiguration.class,
-        properties = {
-            "shenyu.sync.polaris.url=" + PolarisSyncDataConfigurationTest.URL,
-            "shenyu.sync.polaris.namespace=default",
-            "shenyu.sync.polaris.fileGroup=fileGroup"
-        })
+@SpringBootTest(classes = PolarisSyncDataConfiguration.class, properties = {
+        "shenyu.sync.polaris.url=" + PolarisSyncDataConfigurationTest.URL,
+        "shenyu.sync.polaris.namespace=default",
+        "shenyu.sync.polaris.fileGroup=fileGroup"
+})
 @EnableAutoConfiguration
 @MockBean(name = "shenyuConfig", value = ShenyuConfig.class, answer = CALLS_REAL_METHODS)
 public final class PolarisSyncDataConfigurationTest {
 
     public static final String URL = "127.0.0.1:8093";
 
-    @Autowired
+    @MockBean
     private SyncDataService syncDataService;
 
     @Autowired
@@ -68,10 +66,13 @@ public void polarisConfigServiceTest() {
         assertNotNull(polarisConfig);
         final PolarisSyncDataConfiguration polarisSyncDataConfiguration = new PolarisSyncDataConfiguration();
 
-        final ConfigFileService configFileService = Assertions.assertDoesNotThrow(() -> polarisSyncDataConfiguration.polarisConfigServices(polarisConfig));
+        final ConfigFileService configFileService = Assertions
+                .assertDoesNotThrow(() -> polarisSyncDataConfiguration
+                        .polarisConfigServices(polarisConfig));
         assertInstanceOf(DefaultConfigFileService.class, configFileService);
         DefaultConfigFileService defaultConfigFileService = (DefaultConfigFileService) configFileService;
         final SDKContext sdkContext = defaultConfigFileService.getSDKContext();
-        assertTrue(sdkContext.getConfig().getConfigFile().getServerConnector().getAddresses().contains(PolarisSyncDataConfigurationTest.URL));
+        assertTrue(sdkContext.getConfig().getConfigFile().getServerConnector().getAddresses()
+                .contains(PolarisSyncDataConfigurationTest.URL));
     }
 }

From 4535fbfb2d02e419f7528dcacc460d2a0ae4fd0b Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Fri, 16 Jan 2026 12:51:51 +0800
Subject: [PATCH 15/16] refactor: simplify index management in
 DefaultShenyuPluginChain

---
 .../org/apache/shenyu/web/handler/ShenyuWebHandler.java   | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
index 095d4eaabb00..a1901efa4066 100644
--- a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
+++ b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
@@ -44,7 +44,6 @@
 import java.util.Map;
 import java.util.Objects;
 import java.util.Optional;
-import java.util.concurrent.atomic.AtomicInteger;
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
@@ -308,7 +307,7 @@ private void onPluginRemoved(final PluginData pluginData) {
 
     private static class DefaultShenyuPluginChain implements ShenyuPluginChain {
 
-        private final AtomicInteger index = new AtomicInteger(0);
+        private int index;
 
         private final List<ShenyuPlugin> plugins;
 
@@ -330,9 +329,8 @@ private static class DefaultShenyuPluginChain implements ShenyuPluginChain {
         @Override
         public Mono<Void> execute(final ServerWebExchange exchange) {
             return Mono.defer(() -> {
-                int pos;
-                while ((pos = index.getAndIncrement()) < plugins.size()) {
-                    ShenyuPlugin plugin = plugins.get(pos);
+                while (this.index < plugins.size()) {
+                    ShenyuPlugin plugin = plugins.get(this.index++);
                     if (plugin.skip(exchange)) {
                         continue;
                     }

From 61e35df49c6565f5deb3513232e58ba3aaf060a7 Mon Sep 17 00:00:00 2001
From: liuhy <liuhongyu@apache.org>
Date: Fri, 16 Jan 2026 18:58:00 +0800
Subject: [PATCH 16/16] Refactor: adjust ShenyuWebHandler reactive pipeline to
 remove Mono.defer and change `before` execution timing, and add VS Code
 settings and e2e test logs.

---
 .../org/apache/shenyu/web/handler/ShenyuWebHandler.java    | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
index a1901efa4066..5be3e902d04d 100644
--- a/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
+++ b/shenyu-web/src/main/java/org/apache/shenyu/web/handler/ShenyuWebHandler.java
@@ -136,10 +136,9 @@ public void after(final ServerWebExchange exchange) {
      */
     @Override
     public Mono<Void> handle(@NonNull final ServerWebExchange exchange) {
-        return Mono.defer(() -> {
-            before(exchange);
-            return new DefaultShenyuPluginChain(plugins).execute(exchange);
-        }).doOnError(Throwable.class, e -> LOG.error("shenyu execute plugin exception: ", e))
+        before(exchange);
+        return new DefaultShenyuPluginChain(plugins).execute(exchange)
+                .doOnError(Throwable.class, e -> LOG.error("shenyu execute plugin exception: ", e))
                 .doFinally(signalType -> after(exchange))
                 .subscribeOn(scheduled ? scheduler : Schedulers.immediate());
     }