语义化版本（Semver）：Web应用新增重定向是否需要升级主版本号？

语义化版本的标准格式为 X.Y.Z，三个部分对应的升级时机如下：

• 补丁版本（Z位）：仅用于向下兼容的问题修复，不新增任何功能，也不修改现有公开接口/行为的约定，例如修复线上接口报错、页面渲染异常这类不影响原有功能逻辑的bug。
• 次版本（Y位）：用于向下兼容的功能新增、现有功能优化，不会破坏任何已对外公开的行为约定，例如新增可选接口参数、新增不影响原有流程的辅助功能。
• 主版本（X位）：仅当出现不向下兼容的公开API/公开行为变更时升级，只要改动会导致原有符合约定的使用方无法正常运行，就需要升级主版本，例如删除旧接口、修改原有必填参数规则、变更原有接口的默认返回结构。

是否属于不兼容API变更、是否需要升主版本 #

这个问题需要结合你项目已对外公开的行为约定判断：

• 如果该重定向是原有逻辑的兼容补充：比如之前公开约定会话处于特定状态时需要拦截请求，原有实现是返回错误码，现在调整为自动重定向到对应页面，且该行为不会导致符合约定对接的使用方出现异常，则不属于不兼容API变更，不需要升级主版本。
• 如果该重定向破坏了原有公开约定：比如之前约定该场景下会返回固定结构的JSON数据给前端/客户端自行处理，现在直接改为返回302重定向，导致依赖原有返回结构的使用方逻辑报错，则属于不兼容API变更，必须升级主版本。

对应场景的处理建议 #

• 先核对项目对外公开的API文档、行为承诺，确认改动是否和原有约定冲突
• 若为兼容改动：升级次版本号即可，在版本日志中明确说明新增的重定向逻辑规则
• 若为不兼容改动：
  • 方案1：直接升级主版本号，在版本日志中高亮标注本次不兼容变更的影响范围和适配方式
  • 方案2：给重定向逻辑增加开关，仅对新接入的使用方默认开启，旧使用方仍然沿用原有逻辑，这种改动仍然是向下兼容的，仅需升级次版本号即可

内容的提问来源于stack exchange，提问作者Denise E. Robison