报错根源 #

从你提供的建表语句对比能明确问题：

• 生产环境默认字符集是utf8mb3，每个字符最多占3字节，varchar(1000)的索引总长度为1000*3=3000字节，刚好低于InnoDB默认的3072字节限制。
• Docker的MySQL 8默认字符集是utf8mb4，每个字符最多占4字节，varchar(1000)的索引总长度为1000*4=4000字节，超过了3072字节限制，因此触发1071错误。

方案一：对齐生产环境字符集（推荐） #

直接将测试环境的默认字符集改成和生产一致的utf8mb3，从根源规避问题：

1. 启动Docker容器时添加配置参数：

   docker run -d \
     -e MYSQL_ROOT_PASSWORD=your_password \
     mysql:8 \
     --character-set-server=utf8mb3 \
     --collation-server=utf8mb3_unicode_ci
   

2. 或者修改MySQL配置文件（my.cnf）后挂载到容器：

   [mysqld]
   character-set-server=utf8mb3
   collation-server=utf8mb3_unicode_ci
   

方案二：调整配置放宽索引长度限制 #

如果必须保留utf8mb4字符集，可以调整InnoDB相关配置来支持更长索引，但需注意这可能带来性能或兼容性风险：
在MySQL配置中添加以下参数：

[mysqld]
innodb_file_per_table = 1  # 默认已开启，确保处于开启状态
innodb_default_row_format = DYNAMIC  # 或COMPRESSED
innodb_large_prefix = 1  # MySQL 8.0.17及以后版本该参数已废弃，默认生效

重启MySQL服务后生效。

但要注意：即使开启这些配置，InnoDB单列索引的最大长度也仅能到3072字节，utf8mb4下最多支持varchar(768)（768*4=3072），当前的varchar(1000)仍会超出限制。这种情况下，要么将字段长度调整到768以内，要么创建前缀索引：

CREATE INDEX idx_device_designs_name ON testTable (name(768));

内容的提问来源于stack exchange，提问作者Laures