Symfony迁移报错SQLSTATE[42000]：指定键过长（1071）如何修复？

这个错误本质是MySQL InnoDB引擎的索引长度限制搞的鬼——默认情况下，单个索引键的最大长度是767字节。而Symfony通常默认用utf8mb4字符集（支持emoji等特殊字符），每个字符占4字节，算下来单个索引字段的有效长度上限是191字符。你的中间表post_tag用了tag_code作为联合主键的一部分，如果Tag实体里的code字段定义是string(255)，那它的索引长度直接就超了，自然触发报错。

给你三个可行的修复方案，按需选择：

方案一：缩短Tag的code字段长度（最推荐） #

如果你的业务场景不需要code存超过191字符的内容，直接修改Tag实体的code字段注解，把长度限制在191以内：

// App\Entity\Tag.php
/**
 * @ORM\Column(type="string", length=191, unique=true)
 */
private $code;

然后重新生成并执行迁移：

php bin/console make:migration
php bin/console doctrine:migrations:migrate

这个方案最简单，也不会有后续配置隐患。

方案二：开启InnoDB大前缀支持（适合必须保留长字段的场景） #

如果code字段必须存更长的内容，你需要修改MySQL的配置来提升索引长度限制到3072字节。注意这个要求MySQL版本≥5.7.7或MariaDB≥10.2.2，并且你要有服务器配置权限：

1. 找到MySQL的配置文件（通常是my.cnf或my.ini），添加以下配置：

[mysqld]
innodb_large_prefix = on
innodb_file_format = barracuda
innodb_file_per_table = on

2. 重启MySQL服务
3. 重新执行迁移命令即可

方案三：改用Tag的id作为关联字段（性能更优） #

如果业务允许，把中间表的关联字段从tag_code换成Tag的主键id（整数类型），这样完全不会碰到长度限制，还能提升关联查询性能：
修改Post实体的多对多关联注解：

// App\Entity\Post.php
/**
 * @ORM\ManyToMany(targetEntity="App\Entity\Tag", inversedBy="posts")
 * @ORM\JoinTable(name="post_tag",
 * joinColumns={@ORM\JoinColumn(name="post_id", referencedColumnName="id")},
 * inverseJoinColumns={@ORM\JoinColumn(name="tag_id", referencedColumnName="id")}
 * )
 */
private $tags;

之后同样重新生成并执行迁移即可，Tag实体的关联代码不用改动。

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