Zabbix-docker 从6.0.2升级到6.4的数据库升级问题解决方案

在Zabbix监控系统的容器化部署中，从6.0.2版本升级到6.4版本时可能会遇到数据库升级失败的问题。这个问题主要出现在高可用(HA)模式下，系统会拒绝执行数据库升级操作。本文将详细分析问题原因并提供完整的解决方案。

问题现象

当尝试将Zabbix服务器从6.0.2升级到6.4版本时，数据库升级过程会失败，并显示以下错误信息：

cannot perform database upgrade in HA mode: all nodes need to be stopped and Zabbix server started in standalone mode for the time of upgrade.

问题根源

这个问题的根本原因在于Zabbix 6.4版本对数据库升级过程有特殊要求：

1. 数据库升级必须在独立(standalone)模式下进行，不能在高可用(HA)模式下执行
2. 即使已经移除了HA相关的环境变量，某些配置可能仍然会触发HA模式
3. 自动HA节点名称配置(ZBX_AUTOHANODENAME)也会导致系统误认为处于HA模式

解决方案

1. 完全禁用HA模式

确保以下配置项完全移除或注释掉：

• ZBX_HANODENAME
• ZBX_NODEADDRESS
• ZBX_AUTOHANODENAME

特别注意ZBX_AUTOHANODENAME这个参数容易被忽视，它也会导致系统进入HA模式。

2. 数据库准备

在升级前需要对数据库做以下准备：

SET GLOBAL log_bin_trust_function_creators = 1;

3. 升级步骤

1. 停止所有Zabbix服务器节点
2. 清空ha_node表
3. 确保docker-compose.yml中移除了所有HA相关配置
4. 重新创建容器（注意：修改环境变量后必须重建容器）
5. 执行数据库升级
6. 升级完成后，再重新配置HA模式

4. 验证配置

使用以下命令验证最终配置是否正确：

docker compose -f docker-compose.yml config

注意事项

1. 使用Percona XtraDB Cluster或MariaDB Galera集群时，升级期间应切换到单节点模式
2. 确保数据库使用正确的排序规则(utf8_bin, utf8mb3_bin或utf8mb4_bin)
3. 升级过程中不要保留任何旧版本的容器或配置
4. 建议在升级前做好完整备份

总结

Zabbix 6.4版本的数据库升级对HA模式有严格要求，必须确保升级过程在独立模式下完成。通过彻底移除所有HA相关配置，特别是容易被忽视的ZBX_AUTOHANODENAME参数，可以成功完成升级。升级完成后，再根据需要重新配置高可用环境。