禅道升级重定向问题解决方案与实战指南

1. 禅道升级过程中的重定向问题解析

上周帮客户从禅道8.2.1升级到12.5.3时，遇到了经典的"重定向次数过多"错误。这个Windows一键安装版的升级过程看似简单，但实际暗藏玄机。作为经历过多次禅道升级的老兵，我来拆解这个问题的成因和解决方案。

重定向循环通常发生在Nginx/Apache配置与禅道自身路由规则冲突时。在8.x到12.x的大版本跨越中，禅道的URL路由机制发生了重大变化，而旧版的.htaccess或nginx.conf规则可能与之不兼容。典型症状是浏览器不断在/login和/index页面间跳转，最终触发Chrome的"ERR_TOO_MANY_REDIRECTS"警告。

2. 升级前的必要准备工作

2.1 环境检查清单

在开始升级前，务必完成以下检查：

• 当前禅道版本确认（通过访问/zentao/index.php?mode=getbase）
• 备份整个禅道目录（包括attachments和data两个关键文件夹）
• 备份数据库（使用mysqldump或禅道自带的备份功能）
• 记录当前服务器的PHP版本（禅道12.5.3要求PHP5.4+）

重要提示：Windows一键安装版用户需要特别注意，其内置的PHP版本可能过低。我遇到过某次升级失败就是因为自带的PHP5.3无法兼容新版本禅道。

2.2 升级路径规划

禅道不支持跨多个大版本直接升级，正确的升级路径应该是：
8.2.1 → 9.8.3 → 10.6 → 11.6 → 12.5.3

每个中间版本都需要完整执行升级流程，这是很多新手容易忽略的关键点。我曾经尝试从8.x直接升到12.x，结果导致数据表结构损坏，不得不回退重来。

3. 分步升级操作指南

3.1 获取升级包的正确方式

不建议从第三方渠道下载升级包，官方提供了两种安全获取方式：

1. 通过禅道后台的"插件管理"→"版本升级"自动下载
2. 从官网下载对应版本的zip包（注意区分Windows/Linux版本）

下载后验证MD5值是个好习惯。去年就有同行因为用了被篡改的升级包导致安全问题。

3.2 执行升级的核心步骤

1. 停止所有禅道服务（特别是Windows下的zentao服务）
2. 解压升级包覆盖原目录（保留data和attachments）
3. 访问/upgrade.php开始数据库升级
4. 按照向导完成每一步操作

关键细节：在Windows环境下，如果遇到文件占用问题，需要先到任务管理器结束php-cgi.exe进程。这个坑我踩过三次才长记性。

4. 重定向问题的深度解决方案

4.1 配置文件调整

出现重定向循环时，首先检查以下文件：

• /zentao/config/my.php（确保cookie相关配置正确）
• /zentao/.htaccess（Apache）或 /etc/nginx/conf.d/zentao.conf（Nginx）

对于Nginx环境，需要特别注意这段配置：

nginx复制location / {
    try_files $uri $uri/ /index.php?$args;
}

而Apache用户则需要检查RewriteRule是否与禅道12.5.3的规则匹配。建议直接使用新版自带的.htaccess文件替换旧版。

4.2 浏览器端处理技巧

当遇到重定向循环时，可以尝试：

1. 使用Chrome无痕模式（排除插件干扰）
2. 清除浏览器缓存和Cookie（特别是zentao开头的Cookie）
3. 直接访问/zentao/index.php?mode=rebuildurl尝试重建URL规则

有个小技巧：在URL后加?debug=1可以显示部分调试信息，帮助定位问题。

5. 升级后的验证与调优

5.1 基础功能检查清单

升级完成后必须验证：

• 用户登录是否正常（测试不同角色账号）
• 项目-需求-任务-缺陷的关联关系是否完整
• 报表导出功能是否可用
• 邮件通知是否正常发送

5.2 性能优化建议

12.5.3版本在性能上有显著提升，但建议：

1. 调整PHP内存限制到至少256M（php.ini中的memory_limit）
2. 开启OPcache加速（zend_extension=opcache.so）
3. 对于大型部署，建议配置Redis缓存

6. 常见问题速查手册

6.1 典型错误及解决方案

6.2 数据迁移特别注意事项

如果升级后发现数据异常：

1. 使用/zentao/bin/checktable.php检查表结构
2. 对比升级前后的数据库表数量（8.2.1约120张表，12.5.3约150张）
3. 检查data/backup/下的自动备份文件

最后分享一个血泪教训：永远不要在周五下午开始升级操作。有次我低估了升级复杂度，导致团队周末加班回滚版本。现在我的原则是：重大升级必选工作日上午，留足回退时间。