架构

二次开发的边界

哪些改动是授权范围内正常的二次开发、哪些会破坏升级路径、怎么改才能既满足业务又不用每版都合并冲突。

最后更新:2026/11/19

一、先说结论

源码不加密、允许修改,不等于鼓励直接改核心代码。

判断标准很简单:改动会不会让下一次升级无法合并。会,就要换一种做法。

二、三类改动

第一类:扩展(推荐)

不改动原有文件,通过新增实现来满足需求:

  • 新增业务域模块(不影响已有模块)
  • 通过 SPI 扩展点接入自定义逻辑
  • 新增前端页面 / 组件
  • 新增定时任务、字典、参数配置

这类改动升级时几乎不会冲突。

第二类:配置(推荐)

能通过配置解决的不要改代码:

  • 菜单、权限点、角色
  • 字典与业务参数
  • 支付渠道参数
  • 装修模板与页面内容
  • 通知模板

这类改动升级时完全无冲突。

第三类:修改核心(谨慎)

必须改 order / pay / stock / goods 等主链路代码时:

  • 先评估能否用扩展点绕过
  • 确实要改,逐文件记录(改动原因、期望行为、上游原实现)
  • 升级时按记录逐项核对,而不是无脑接受某一方

三、不建议做的四件事

  1. 改表结构不写迁移脚本:升级后新环境建不出来
  2. 直接改第三方依赖:升级依赖时改动丢失
  3. 在 Controller 里写业务规则:后续无法被其它入口复用
  4. 把运营配置写死在代码里:每次调整都要发版

四、升级时的合并策略

改动类型合并方式
新增文件直接保留,无需处理
配置文件以新版为基线,重新应用自己的键值
核心代码小改逐处比对,按记录确认
核心代码大改优先重构成扩展点,避免长期维护分叉

五、怎么判断改动量是否失控

一个可量化的信号:升级时需要人工比对的文件数。

  • 10 个以内:正常
  • 10~50 个:需要建立改动清单并持续维护
  • 50 个以上:说明二次开发已经偏离主线,建议重新评估方案

六、授权范围内的边界

二次开发在版本授权范围内进行:

  • 开源版(Apache-2.0):可自由修改、可再分发,需保留 LICENSE 与 NOTICE
  • 商用版:授权到企业主体、不限域名,修改后的代码归属按合同约定

超出授权范围的转售、拆分授权、去除版权信息,不在允许范围内。

需要针对你的场景给建议?

不用先看完全部文档。说清产品线与当前进度,我们直接给判断。