ProxySQL中query_cache_size系统变量未知问题的分析与解决

问题背景

在使用ProxySQL 2.6.2版本时，通过Spring Boot应用连接数据库时遇到了"Unknown system variable 'query_cache_size'"的错误。这个错误表面上看是JDBC驱动尝试设置一个MySQL不再支持的参数，但实际上反映了ProxySQL配置中的一个关键问题。

问题本质分析

这个错误的核心在于ProxySQL向客户端报告的MySQL版本信息与实际后端MySQL版本不匹配。MySQL 8.0版本已经移除了query_cache_size参数，而某些JDBC驱动仍会尝试设置这个参数。

在ProxySQL中，mysql-server_version参数控制着ProxySQL向客户端报告的MySQL版本号。如果这个值设置不正确（比如设置为5.7而不是实际的8.0），就会导致JDBC驱动尝试使用不兼容的参数。

解决方案详解

1. 正确配置mysql-server_version参数
   确保ProxySQL的配置文件中mysql-server_version参数与后端MySQL实际版本一致。例如，如果后端是MySQL 8.0.33，则应设置为：

   server_version="8.0.33"
   

2. 配置文件生效机制
   需要注意的是，ProxySQL在首次启动时会读取proxysql.cnf文件，但之后会创建并使用proxysql.db文件存储配置。这意味着：

   • 修改proxysql.cnf后需要删除proxysql.db才能让新配置生效
   • 或者通过Admin接口动态修改配置并保存

3. 版本降级误区
   用户报告降级到2.6.1版本解决了问题，实际上这是因为在降级过程中可能无意中删除了旧的proxysql.db文件，使得新配置得以生效，而非版本本身的问题。

最佳实践建议

1. 在部署ProxySQL前，明确后端MySQL的实际版本
2. 通过Admin接口验证当前生效的配置：

   SELECT * FROM global_variables WHERE variable_name='mysql-server_version';
   

3. 如需修改配置，建议通过Admin接口进行：

   UPDATE global_variables SET variable_value='8.0.33' WHERE variable_name='mysql-server_version';
   LOAD MYSQL VARIABLES TO RUNTIME;
   SAVE MYSQL VARIABLES TO DISK;
   

4. 对于生产环境，建议通过配置管理工具确保配置一致性

总结

ProxySQL作为MySQL中间件，其版本报告机制对客户端行为有重要影响。正确处理mysql-server_version参数可以避免因版本不匹配导致的兼容性问题。理解ProxySQL的配置加载机制对于正确管理配置变更至关重要，避免陷入"版本降级解决问题"的误区。