SOFA-ARK 插件新增依赖包含能力优化模块瘦身方案

SOFA-ARK 作为一款优秀的 Java 模块化开发框架，其 maven 插件 sofa-ark-maven-plugin 在模块瘦身方面一直提供着强大的支持。近期社区针对插件功能进行了重要增强，新增了 includeGroupIds 和 includeArtifactIds 配置项，为模块依赖管理提供了更灵活的解决方案。

背景与痛点

在微服务架构下，多个业务模块合并部署至基座时，各模块间的依赖管理面临挑战。虽然大部分基础依赖相同，但每个模块都可能存在少量特有依赖。传统使用 rules.txt、rules.properties 或 rules.yml 进行瘦身配置的方式存在以下问题：

1. 每个模块需要单独配置，导致大量重复内容
2. 开发人员需要不断排查依赖树，工作量大
3. 配置维护成本高，容易出错

新特性解析

新版本插件新增了两项重要配置：

1. includeGroupIds：指定需要包含的 groupId 模式
2. includeArtifactIds：指定需要包含的 artifactId 模式

这些配置项与原有的 excludeGroupIds 和 excludeArtifactIds 形成互补，为依赖管理提供了更完整的解决方案。

使用场景示例

假设某业务模块需要保留 com.xxxx 组下的所有依赖，同时排除其他所有依赖，可以这样配置：

<plugin>
    <groupId>com.alipay.sofa</groupId>
    <artifactId>sofa-ark-maven-plugin</artifactId>
    <configuration>
        <excludeGroupIds>*</excludeGroupIds>
        <includeGroupIds>com.xxxx*</includeGroupIds>
    </configuration>
</plugin>

这种配置方式相比传统方法具有以下优势：

1. 配置简化：无需为每个模块编写大量排除规则
2. 维护方便：集中管理包含规则，修改一处即可影响所有模块
3. 问题定位快：运行时出现类找不到异常时，能快速判断类库应放在模块还是基座

技术实现原理

在插件内部，新的包含规则会与排除规则共同作用：

1. 首先应用包含规则，标记需要保留的依赖
2. 然后应用排除规则，进一步过滤不需要的依赖
3. 最终形成模块的依赖集合

这种处理顺序确保了包含规则具有更高优先级，符合开发者的预期。

最佳实践建议

1. 基座与模块分工：将通用依赖下沉到基座，模块只保留特有依赖
2. 模式匹配使用：合理使用 * 通配符简化配置
3. 渐进式调整：可以先配置严格包含规则，再根据运行情况逐步调整
4. 依赖分析：配合 mvn dependency:tree 命令分析依赖关系

未来展望

虽然当前版本已经解决了大部分需求，但社区仍在持续优化瘦身方案。未来的发展方向可能包括：

1. 全局黑名单配置支持
2. 更智能的依赖分析工具
3. 可视化依赖管理界面
4. 基于使用情况的自动瘦身建议

这项功能的加入显著提升了 SOFA-ARK 在复杂微服务场景下的模块管理能力，为开发者提供了更高效、更灵活的依赖控制手段。