mysql 8.0.13+ 函数索引必须用双括号((...))包裹表达式，少一个括号会报错或静默失败；仅支持确定性函数，需注意排序规则、标识符转义及查询条件与索引表达式严格一致。
CREATE INDEX 语法中双括号漏写一个
MySQL 8.0.13+ 要求函数索引的表达式必须用 ((...)) 包裹，少一个括号就会被当成普通列名处理，直接报错 Unknown column 'xxx' in 'table definition' 或静默创建失败（实际建的是列索引而非函数索引）。
- 错误写法：
CREATE INDEX idx_name ON users ((length(name)));→ 少一个左括号，语法不合法 - 正确写法：
CREATE INDEX idx_name ON users ((length(name)));→ 注意是两个左括号、两个右括号 - 验证是否成功：查
information_schema.STATISTICS，INDEX_TYPE应为BTREE，且EXPRESSION列（MySQL 8.0.23+）会显示函数表达式；老版本可看INDEX_COMMENT是否为空或含提示
函数不支持或参数类型不匹配
不是所有函数都能用于函数索引。MySQL 只允许确定性（deterministic）、无副作用、能被索引引擎安全计算的函数。比如 NOW()、RAND()、USER() 会被拒绝；SUBSTRING() 要求长度参数为常量，否则报错 Function is not allowed in index expression。
- 常见可用函数：
UPPER()、LOWER()、MD5()、SHA2()、TRIM()、YEAR()、DATE()、CAST(... AS ...) - 典型错误：
CREATE INDEX idx ON logs ((SUBSTRING(content, 1, @len)));→@len是用户变量，非确定性，不允许 - 修复方式：改用字面量，如
SUBSTRING(content, 1, 10)；或先用生成列存结果，再对生成列建普通索引
字段类型或字符集导致隐式转换
即使语法和函数都合法，如果函数输入列本身存在隐式转换风险，MySQL 仍可能拒绝创建函数索引。例如对 VARCHAR 列用 UPPER()，但列用的是 utf8mb4_0900_as_cs（大小写敏感）排序规则，而 UPPER() 在该规则下行为未定义，建索引会失败。
- 检查排序规则：
SHOW FULL COLUMNS FROM users LIKE 'name';看Collation字段 - 稳妥做法：统一用大小写不敏感排序规则，如
utf8mb4_0900_ai_ci - 绕过方式：不用
UPPER()，改用生成列 + 普通索引，或应用层保证输入格式一致
索引名或表名含特殊字符未转义
当表名、列名或索引名包含短横线、空格或保留字时，没加反引号会导致解析错误，看起来像函数索引问题，实则是 SQL 解析失败。
- 错误示例：
CREATE INDEX user-email-idx ON user-data ((LOWER(email)));→ 三个破折号让解析器崩溃 - 正确写法：
CREATE INDEX `user-email-idx` ON `user-data` ((LOWER(`email`))); - 建议：所有标识符都加反引号，尤其在自动化脚本中，避免依赖命名习惯
LOWER(email)，那查询里也必须写 WHERE LOWER(email) = 'a@b.com' 才能命中；写成 WHERE email = 'A@B.COM' 就完全失效——这点很容易被忽略，而且 EXPLAIN 不会报错，只会安静地走全表扫描。
