ProxySQL中stats_mysql_query_digest.digest字段空格问题分析

在ProxySQL数据库中间件的使用过程中，开发人员发现了一个关于SQL查询摘要(digest)生成的特殊问题。当执行特定格式的SQL查询时，生成的摘要字符串中会意外包含空格字符，这可能导致查询路由规则失效。

问题现象

在ProxySQL 2.7.0-11-g3835029版本中，执行如下SQL查询：

SELECT * FROM workshop_labour_unavailable WHERE Type = 'Workshop' AND Depot = 'STOCK';

生成的摘要(digest)会包含一个前导空格，形式为："0x 6E817ACFD8D15DC"。这个空格字符会导致将该摘要值插入mysql_query_rules表时被解析为NULL值，进而使该规则匹配所有查询，造成非预期的路由行为。

技术背景

ProxySQL的查询摘要功能是其核心特性之一，它通过对SQL查询进行哈希处理生成唯一的指纹，用于查询分类、统计和路由。摘要值通常以十六进制字符串形式表示，预期应为连续的字符序列。

在内部实现上，ProxySQL使用特定的哈希算法对规范化后的SQL查询进行处理。规范化过程会去除查询中的变量值、空格等不影响语义的元素，保留查询的结构特征。

问题影响

该问题会导致以下影响：

1. 路由规则失效：包含空格的摘要值在插入规则表时会被视为NULL，NULL在匹配规则中具有特殊含义，会匹配所有查询。

2. 统计信息不准确：由于摘要值异常，相同的查询可能被统计到不同的摘要条目下。

3. 性能优化困难：基于摘要的查询分析和优化策略可能无法正确实施。

解决方案

ProxySQL开发团队已经确认该问题，并在后续版本中修复。修复方案主要涉及：

1. 修正摘要生成逻辑，确保生成的十六进制字符串不包含任何空格字符。

2. 增强摘要值的验证机制，防止异常值进入规则系统。

对于当前版本的用户，临时解决方案是手动去除摘要中的空格字符后再插入规则表。

最佳实践

为避免类似问题，建议：

1. 定期升级ProxySQL到最新稳定版本，获取问题修复和功能改进。

2. 在应用查询规则前，验证生成的摘要值是否符合预期格式。

3. 对于关键业务查询，实施全面的测试验证，确保路由行为符合预期。

4. 监控stats_mysql_query_digest表中的数据，及时发现异常摘要值。

该问题的修复体现了ProxySQL社区对产品质量的持续关注，也提醒我们在使用数据库中间件时要关注细节验证，确保核心功能的正确性。