Debian系统MySQL 8.0.31启用FEDERATED引擎报‘--federated未知’求助

DevOps 小满

2026-8-6

解决Debian下MySQL 8.0.31 FEDERATED引擎激活失败的问题

排查配置文件错误：
你大概率是把federated参数放错了配置段或者写法有误。Debian环境下，MySQL服务端的配置要写在/etc/mysql/mysql.conf.d/mysqld.cnf的[mysqld]区块内，直接写federated即可（不要加--前缀），示例如下：
```
[mysqld]
# 保留原有配置
federated
```
注意别把这个参数放到[mysql]或其他客户端配置段里，否则启动时会触发unknown option '--federated'错误。
正确重启服务：
不需要给systemctl加--federated参数，MySQL服务端参数仅需在配置文件中定义，执行常规重启命令即可：
```
systemctl restart mysql
```
手动安装插件（配置后仍不生效时）：
登录MySQL，执行以下命令检查是否已加载FEDERATED插件：
```
SHOW PLUGINS;
```
如果未找到FEDERATED相关条目，手动安装插件：
```
INSTALL PLUGIN FEDERATED SONAME 'ha_federated.so';
```
安装完成后执行SHOW ENGINES;，就能看到FEDERATED状态变为YES。同时确保配置文件里的federated参数存在，后续重启服务会自动加载该引擎。