目录⚠️最重要前置结论一、环境差异重大提醒极易踩坑二、升级前标准准备必做1. 完整备份每一步升级前都执行2. 下载对应版本【源码包 ZIP】3. 业务窗口三、通用单版本升级操作流程每个过渡版本重复这套操作四、分段升级重点注意事项① 11.5 → 12.5.3② 12.5.3 → 16.5③ 16.5 → 17.8【最重要分水岭】④ 17.8 → 18.13⑤ 18.13 → 22.4五、更稳妥的备选方案强烈推荐生产环境优先考虑六、高频故障预案七、补充提问你回复我可以给你针对性命令 / 排错⚠️最重要前置结论11.5 不能直接一步升级到 22.4跨 1 个大版本数据库结构、PHP 语法、框架全部重构必须分段过渡升级。官方推荐过渡路线经过大量社区验证最稳路线11.5 → 12.5.3 → 16.5 → 17.8 → 18.13 → 22.4硬性规则每升级完成一个版本必须完整备份优先搭建测试服务器完整跑通全部流程再操作生产环境一、环境差异重大提醒极易踩坑禅道 11.5PHP5.6 / 7.0MySQL5.5 / 5.612.5.3 /16.5PHP7.1~7.417.x ~ 18.13PHP 最低 7.4推荐 7.4~8.1MySQL 建议 ≥5.7禅道 22.4PHP7.4 ~ 8.2不再支持 PHP5.xMySQL5.7 / 8.0强烈建议 MySQL8.0utf8mb4关键如果你是官方一键安装包Windows/Linux zbox前期 11.5→12.5.3 可以使用内置环境升级到 17.8 前后旧环境内置 PHP5.6/MySQL5.6 会无法继续两种选择 方案 A推荐升级到 18.13 之后新建 22.4 一键包导出 18.13 数据库 附件迁移到新环境方案 B分步替换 zbox 集成环境风险更高。二、升级前标准准备必做1. 完整备份每一步升级前都执行两种备份同时做双重保险 1禅道后台备份后台 → 系统 → 备份下载 sql、附件文件包 2命令行物理备份Linux 一键包示例# 停止服务 /opt/zbox/zbox stop # 备份整个zbox目录 cp -r /opt/zbox /opt/zbox_11.5_backup # 数据库单独导出 /opt/zbox/bin/mysqldump -u root -p zentao zentao_11.5.sql /opt/zbox/zbox startWindows 一键包直接复制整个xampp/zbox文件夹作为完整备份。2. 下载对应版本【源码包 ZIP】❗不要下载一键安装包 exe/tar升级只用 ZenTaoPMS.x.x.stable.zip源码包下载地址https://www.zentao.net/download.html 搜索版本号 需要下载ZenTaoPMS.12.5.3.stable.zipZenTaoPMS.16.5.stable.zipZenTaoPMS.17.8.stable.zipZenTaoPMS.18.13.stable.zipZenTaoPMS.22.4.stable.zip3. 业务窗口选择无人使用时段升级期间禁止所有人操作禅道。三、通用单版本升级操作流程每个过渡版本重复这套操作适用于Linux 一键包 / Windows 一键包停止禅道服务解压源码包得到文件夹zentaopms覆盖文件Linux 一键包cp -rf zentaopms/* /opt/zbox/app/zentao/Windows 一键包把 zentaopms 内全部文件复制到xampp\zentao\✅重点不要复制成/zentao/zentaopms/路径嵌套会直接报错启动 ApacheMySQL 服务浏览器访问升级地址http://你的地址/zentao/upgrade.php按照页面向导执行数据库升级等待 SQL 脚本执行完毕不要中途关闭页面升级成功后登录禅道检查项目、bug、任务、附件、文档是否正常立刻再次完整备份确认无误再进行下一个版本升级四、分段升级重点注意事项① 11.5 → 12.5.312.x 是重要分水岭大量数据表结构调整升级后登录检查附件链接是否有效若 PHP 是 5.6可以正常运行到此版本② 12.5.3 → 16.5功能模块重构注意自定义视图、自定义字段旧插件大概率失效升级前全部禁用第三方插件③ 16.5 → 17.8【最重要分水岭】17.0 开始启用全新【项目集架构】旧项目结构迁移关键点PHP5.6 彻底不再支持⚠️如果你使用老旧一键安装包内置 PHP5.6 升级到 17.8 一定会报 PHP 语法错误 解决办法二选一 方式 1新建搭载 PHP7.4MySQL5.7 的禅道一键包把 16.5 备份导入新环境再升级 17.8 方式 2升级 zbox 集成环境操作复杂不推荐新手④ 17.8 → 18.13稳定过渡版本建议停留验证 1~2 天确认所有业务正常⑤ 18.13 → 22.422 系列前端全面重构UI 大改版API、权限体系调整 升级完成后清理缓存zentao/tmp/下 cache 目录清空管理员进入后台检查角色权限部分权限会重置旧客户端、第三方集成接口api需要测试适配五、更稳妥的备选方案强烈推荐生产环境优先考虑不原地逐级升级采用「迁移升级法」故障回滚最简单测试服务器原地逐级升级11.5 →12.5.3→16.5→17.8→18.13→22.4验证全部数据、附件、功能正常生产环境操作 1停机完整备份 11.5 数据 2全新部署禅道 22.4 一键安装包3在测试环境把数据逐级升到 22.4导出最终 SQL www/upload 附件目录 4导入到新 22.4 环境 优点旧环境完整保留一旦新版有问题随时切回旧 11.5避免生产环境长时间逐级升级风险。六、高频故障预案upgrade.php 空白 / 500 错误PHP 版本不匹配文件覆盖路径错误目录权限不足Linuxchmod -R 755 /opt/zbox/app/zentao chmod -R 777 /opt/zbox/app/zentao/tmp升级页面执行 SQL 报错不要强行刷新恢复上一个版本备份核对升级顺序是否跳版本附件打不开、图片裂图检查www/upload文件夹完整复制权限读写开启登录成功页面功能报错 SQL 不存在字段典型跳版本升级导致数据库结构不兼容只能回滚严格按顺序升级七、补充提问你回复我可以给你针对性命令 / 排错当前部署方式Linux 一键包 / Windows 一键包 / 源码独立部署宝塔等当前 PHP、MySQL 版本是否有自定义插件、二次开发代码是否有第三方系统调用禅道 API 禅道开源版 11.5 → 22.4 完整升级方案
目录⚠️最重要前置结论一、环境差异重大提醒极易踩坑二、升级前标准准备必做1. 完整备份每一步升级前都执行2. 下载对应版本【源码包 ZIP】3. 业务窗口三、通用单版本升级操作流程每个过渡版本重复这套操作四、分段升级重点注意事项① 11.5 → 12.5.3② 12.5.3 → 16.5③ 16.5 → 17.8【最重要分水岭】④ 17.8 → 18.13⑤ 18.13 → 22.4五、更稳妥的备选方案强烈推荐生产环境优先考虑六、高频故障预案七、补充提问你回复我可以给你针对性命令 / 排错⚠️最重要前置结论11.5 不能直接一步升级到 22.4跨 1 个大版本数据库结构、PHP 语法、框架全部重构必须分段过渡升级。官方推荐过渡路线经过大量社区验证最稳路线11.5 → 12.5.3 → 16.5 → 17.8 → 18.13 → 22.4硬性规则每升级完成一个版本必须完整备份优先搭建测试服务器完整跑通全部流程再操作生产环境一、环境差异重大提醒极易踩坑禅道 11.5PHP5.6 / 7.0MySQL5.5 / 5.612.5.3 /16.5PHP7.1~7.417.x ~ 18.13PHP 最低 7.4推荐 7.4~8.1MySQL 建议 ≥5.7禅道 22.4PHP7.4 ~ 8.2不再支持 PHP5.xMySQL5.7 / 8.0强烈建议 MySQL8.0utf8mb4关键如果你是官方一键安装包Windows/Linux zbox前期 11.5→12.5.3 可以使用内置环境升级到 17.8 前后旧环境内置 PHP5.6/MySQL5.6 会无法继续两种选择 方案 A推荐升级到 18.13 之后新建 22.4 一键包导出 18.13 数据库 附件迁移到新环境方案 B分步替换 zbox 集成环境风险更高。二、升级前标准准备必做1. 完整备份每一步升级前都执行两种备份同时做双重保险 1禅道后台备份后台 → 系统 → 备份下载 sql、附件文件包 2命令行物理备份Linux 一键包示例# 停止服务 /opt/zbox/zbox stop # 备份整个zbox目录 cp -r /opt/zbox /opt/zbox_11.5_backup # 数据库单独导出 /opt/zbox/bin/mysqldump -u root -p zentao zentao_11.5.sql /opt/zbox/zbox startWindows 一键包直接复制整个xampp/zbox文件夹作为完整备份。2. 下载对应版本【源码包 ZIP】❗不要下载一键安装包 exe/tar升级只用 ZenTaoPMS.x.x.stable.zip源码包下载地址https://www.zentao.net/download.html 搜索版本号 需要下载ZenTaoPMS.12.5.3.stable.zipZenTaoPMS.16.5.stable.zipZenTaoPMS.17.8.stable.zipZenTaoPMS.18.13.stable.zipZenTaoPMS.22.4.stable.zip3. 业务窗口选择无人使用时段升级期间禁止所有人操作禅道。三、通用单版本升级操作流程每个过渡版本重复这套操作适用于Linux 一键包 / Windows 一键包停止禅道服务解压源码包得到文件夹zentaopms覆盖文件Linux 一键包cp -rf zentaopms/* /opt/zbox/app/zentao/Windows 一键包把 zentaopms 内全部文件复制到xampp\zentao\✅重点不要复制成/zentao/zentaopms/路径嵌套会直接报错启动 ApacheMySQL 服务浏览器访问升级地址http://你的地址/zentao/upgrade.php按照页面向导执行数据库升级等待 SQL 脚本执行完毕不要中途关闭页面升级成功后登录禅道检查项目、bug、任务、附件、文档是否正常立刻再次完整备份确认无误再进行下一个版本升级四、分段升级重点注意事项① 11.5 → 12.5.312.x 是重要分水岭大量数据表结构调整升级后登录检查附件链接是否有效若 PHP 是 5.6可以正常运行到此版本② 12.5.3 → 16.5功能模块重构注意自定义视图、自定义字段旧插件大概率失效升级前全部禁用第三方插件③ 16.5 → 17.8【最重要分水岭】17.0 开始启用全新【项目集架构】旧项目结构迁移关键点PHP5.6 彻底不再支持⚠️如果你使用老旧一键安装包内置 PHP5.6 升级到 17.8 一定会报 PHP 语法错误 解决办法二选一 方式 1新建搭载 PHP7.4MySQL5.7 的禅道一键包把 16.5 备份导入新环境再升级 17.8 方式 2升级 zbox 集成环境操作复杂不推荐新手④ 17.8 → 18.13稳定过渡版本建议停留验证 1~2 天确认所有业务正常⑤ 18.13 → 22.422 系列前端全面重构UI 大改版API、权限体系调整 升级完成后清理缓存zentao/tmp/下 cache 目录清空管理员进入后台检查角色权限部分权限会重置旧客户端、第三方集成接口api需要测试适配五、更稳妥的备选方案强烈推荐生产环境优先考虑不原地逐级升级采用「迁移升级法」故障回滚最简单测试服务器原地逐级升级11.5 →12.5.3→16.5→17.8→18.13→22.4验证全部数据、附件、功能正常生产环境操作 1停机完整备份 11.5 数据 2全新部署禅道 22.4 一键安装包3在测试环境把数据逐级升到 22.4导出最终 SQL www/upload 附件目录 4导入到新 22.4 环境 优点旧环境完整保留一旦新版有问题随时切回旧 11.5避免生产环境长时间逐级升级风险。六、高频故障预案upgrade.php 空白 / 500 错误PHP 版本不匹配文件覆盖路径错误目录权限不足Linuxchmod -R 755 /opt/zbox/app/zentao chmod -R 777 /opt/zbox/app/zentao/tmp升级页面执行 SQL 报错不要强行刷新恢复上一个版本备份核对升级顺序是否跳版本附件打不开、图片裂图检查www/upload文件夹完整复制权限读写开启登录成功页面功能报错 SQL 不存在字段典型跳版本升级导致数据库结构不兼容只能回滚严格按顺序升级七、补充提问你回复我可以给你针对性命令 / 排错当前部署方式Linux 一键包 / Windows 一键包 / 源码独立部署宝塔等当前 PHP、MySQL 版本是否有自定义插件、二次开发代码是否有第三方系统调用禅道 API