2026年6月10日 (三) 22:01 Doge24190

2026-06-10T22:01:35Z

←上一版本		2026年6月11日 (四) 06:01的版本
第180行：		第180行：
	对于使用 Oracle Cloud MySQL、阿里云 RDS、腾讯云数据库、AWS RDS 等云服务商数据库系统的用户来说，这类问题并不罕见。云数据库通常更偏向稳定、安全和统一管理，因此会禁用一些旧式或不推荐的特性。安装传统 PHP 程序时，如果遇到类似报错，应优先检查程序的建表 SQL 是否使用了云数据库不支持的存储引擎。		对于使用 Oracle Cloud MySQL、阿里云 RDS、腾讯云数据库、AWS RDS 等云服务商数据库系统的用户来说，这类问题并不罕见。云数据库通常更偏向稳定、安全和统一管理，因此会禁用一些旧式或不推荐的特性。安装传统 PHP 程序时，如果遇到类似报错，应优先检查程序的建表 SQL 是否使用了云数据库不支持的存储引擎。
	[[分类:MediaWiki]]		[[分类:MediaWiki]]
			[[分类:技术博客]]

2026年6月10日 (三) 21:42 Doge24190

2026-06-10T21:42:47Z

←上一版本		2026年6月11日 (四) 05:42的版本
第179行：		第179行：

	对于使用 Oracle Cloud MySQL、阿里云 RDS、腾讯云数据库、AWS RDS 等云服务商数据库系统的用户来说，这类问题并不罕见。云数据库通常更偏向稳定、安全和统一管理，因此会禁用一些旧式或不推荐的特性。安装传统 PHP 程序时，如果遇到类似报错，应优先检查程序的建表 SQL 是否使用了云数据库不支持的存储引擎。		对于使用 Oracle Cloud MySQL、阿里云 RDS、腾讯云数据库、AWS RDS 等云服务商数据库系统的用户来说，这类问题并不罕见。云数据库通常更偏向稳定、安全和统一管理，因此会禁用一些旧式或不推荐的特性。安装传统 PHP 程序时，如果遇到类似报错，应优先检查程序的建表 SQL 是否使用了云数据库不支持的存储引擎。
			[[分类:MediaWiki]]

Doge24190：创建页面，内容为“= 使用云服务商 MySQL 安装 MediaWiki 时遇到 MyISAM 被禁用的解决记录 = == 问题背景 == 在安装 MediaWiki 时，如果数据库使用的不是本机自建 MySQL，而是云服务商提供的托管数据库系统，例如： * Oracle Cloud MySQL HeatWave * 阿里云 RDS MySQL * 腾讯云云数据库 MySQL * AWS RDS / Aurora MySQL * Google Cloud SQL for MySQL 那么在安装过程中可能会遇到与传统自建 MySQL 不同的问题。…”

2026-06-10T21:31:16Z

创建页面，内容为“= 使用云服务商 MySQL 安装 MediaWiki 时遇到 MyISAM 被禁用的解决记录 = == 问题背景 == 在安装 MediaWiki 时，如果数据库使用的不是本机自建 MySQL，而是云服务商提供的托管数据库系统，例如： * Oracle Cloud MySQL HeatWave * 阿里云 RDS MySQL * 腾讯云云数据库 MySQL * AWS RDS / Aurora MySQL * Google Cloud SQL for MySQL 那么在安装过程中可能会遇到与传统自建 MySQL 不同的问题。…”

新页面

= 使用云服务商 MySQL 安装 MediaWiki 时遇到 MyISAM 被禁用的解决记录 =

== 问题背景 ==
在安装 MediaWiki 时，如果数据库使用的不是本机自建 MySQL，而是云服务商提供的托管数据库系统，例如：

* Oracle Cloud MySQL HeatWave
* 阿里云 RDS MySQL
* 腾讯云云数据库 MySQL
* AWS RDS / Aurora MySQL
* Google Cloud SQL for MySQL

那么在安装过程中可能会遇到与传统自建 MySQL 不同的问题。

我这次使用的是 Oracle Cloud 创建的 MySQL 数据库系统，并让同一 VCN 内的服务器通过内网连接该数据库。前面的数据库连接、用户授权都处理完成后，MediaWiki 在创建数据表时出现了如下错误：
<code>Error 3161: Storage engine MyISAM is disabled (Table creation is disallowed).

Function: Wikimedia\Rdbms\Database::sourceFile(
/www/wwwroot/mediawiki-1.45.3/sql/mysql/tables-generated.sql
)

Query:
CREATE TABLE `my_wikisearchindex` (
si_page INT UNSIGNED NOT NULL,
si_title MEDIUMTEXT NOT NULL,
si_text MEDIUMTEXT NOT NULL,
FULLTEXT INDEX si_title (si_title),
FULLTEXT INDEX si_text (si_text),
PRIMARY KEY(si_page)
) ENGINE = MyISAM DEFAULT CHARSET = utf8mb4</code>
核心错误是：
<code>Storage engine MyISAM is disabled</code>
也就是说，MediaWiki 的安装 SQL 尝试创建一个使用 MyISAM 存储引擎的数据表，但云服务商的 MySQL 数据库系统禁用了 MyISAM，因此建表失败。

== 为什么云数据库会出现这个问题？ ==
MySQL 早期有多个存储引擎，其中比较常见的是：

* InnoDB
* MyISAM

现代 MySQL 默认推荐使用 InnoDB。相比 MyISAM，InnoDB 支持事务、崩溃恢复、行级锁、外键等特性，更适合现代 Web 应用。

而 MyISAM 是较旧的存储引擎，它没有事务支持，崩溃恢复能力和并发处理能力也较弱。很多云服务商为了安全性、稳定性和统一管理，会直接禁用 MyISAM。

因此在自建 MySQL 中可能还能正常执行的建表语句：
<code>ENGINE = MyISAM</code>
到了云服务商的托管 MySQL 环境中，就可能直接报错。

== MediaWiki 为什么会用到 MyISAM？ ==
报错中出问题的表是：
<code>searchindex</code>
如果安装时设置了表前缀，例如我这里使用了：
<code>my_wiki</code>
那么实际表名会变成：
<code>my_wikisearchindex</code>
这个表主要用于 MediaWiki 的站内全文搜索。

MediaWiki 历史上将搜索索引表设置为 MyISAM，主要是因为早期 MySQL 中 FULLTEXT 全文索引主要依赖 MyISAM。后来 MySQL 的 InnoDB 也已经支持 FULLTEXT，因此在现代 MySQL 版本中，将该表改为 InnoDB 通常是可行的。

== 解决方法：将 MyISAM 替换为 InnoDB ==
MediaWiki 1.45.3 中，相关建表 SQL 文件位于：
<code>/www/wwwroot/mediawiki-1.45.3/sql/mysql/tables-generated.sql</code>
在修改前，建议先备份原文件：
<code>cd /www/wwwroot/mediawiki-1.45.3

sudo cp sql/mysql/tables-generated.sql \
sql/mysql/tables-generated.sql.bak</code>
然后将其中的 MyISAM 替换为 InnoDB：
<code>sudo sed -i 's/ENGINE = MyISAM/ENGINE = InnoDB/g' \
sql/mysql/tables-generated.sql

sudo sed -i 's/ENGINE=MyISAM/ENGINE=InnoDB/g' \
sql/mysql/tables-generated.sql</code>
替换后可以检查是否还存在 MyISAM：
<code>grep -n "MyISAM" sql/mysql/tables-generated.sql</code>
如果没有输出，说明这个文件中已经没有 MyISAM 建表语句。

也可以检查 InnoDB 替换结果：
<code>grep -n "ENGINE = InnoDB" sql/mysql/tables-generated.sql</code>

== 注意：安装失败后建议清空数据库重新安装 ==
如果 MediaWiki 已经安装到一半失败，数据库中可能已经创建了一部分表。为了避免残留表影响后续安装，建议删除并重新创建数据库。

进入 MySQL 管理员账号后执行：
<code>DROP DATABASE IF EXISTS mediawiki;

CREATE DATABASE mediawiki
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;</code>
如果数据库用户已经创建过，也可以重新授权：
<code>GRANT ALL PRIVILEGES ON mediawiki.* TO 'mediawiki'@'10.0.0.47';

FLUSH PRIVILEGES;</code>
其中：
<code>10.0.0.47</code>
需要替换成实际 Web 服务器的内网 IP。

如果当前只是为了先跑通安装，也可以临时使用：
<code>GRANT ALL PRIVILEGES ON mediawiki.* TO 'mediawiki'@'%';

FLUSH PRIVILEGES;</code>
不过长期使用时，更推荐限制为指定内网 IP，而不是使用通配符 <code>%</code>。

== 安装完成后检查表引擎 ==
安装完成后，建议检查数据库中是否还有 MyISAM 表。

进入 MySQL 后执行：
<code>SELECT TABLE_NAME, ENGINE
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'mediawiki'
ORDER BY ENGINE, TABLE_NAME;</code>
如果想只检查 MyISAM 表，可以执行：
<code>SELECT TABLE_NAME, ENGINE
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'mediawiki'
AND ENGINE = 'MyISAM';</code>
如果返回空结果，说明当前数据库中没有 MyISAM 表。

也可以单独检查搜索索引表：
<code>SHOW CREATE TABLE my_wikisearchindex\G</code>
如果没有设置表前缀，则表名可能是：
<code>SHOW CREATE TABLE searchindex\G</code>
重点确认其中包含：
<code>ENGINE=InnoDB</code>
以及 FULLTEXT 索引是否正常存在。

== 这样修改会不会有后患？ ==
从实际使用角度看，将 MediaWiki 的搜索索引表从 MyISAM 改为 InnoDB，一般不会影响正常运行。

因为 MyISAM / InnoDB 是建表时指定的存储引擎。一旦表已经创建为 InnoDB，MediaWiki 后续运行时主要执行的是：

* INSERT
* UPDATE
* SELECT
* DELETE
* ALTER TABLE
* CREATE INDEX

它不会在普通访问、编辑页面、上传文件、搜索页面时自动把表切回 MyISAM。

对于现代 MySQL 来说，InnoDB 反而是更推荐的选择。它具有更好的事务支持、崩溃恢复能力和并发处理能力，也更符合云数据库系统的默认管理策略。

== 后续维护和升级时的注意事项 ==
这个问题真正需要注意的是后续升级。

由于这次修改的是 MediaWiki 源码目录中的 SQL 文件：
<code>sql/mysql/tables-generated.sql</code>
所以以后升级 MediaWiki 时，如果换成了新的源码目录，或者覆盖了原来的 SQL 文件，官方包中的 <code>ENGINE = MyISAM</code> 可能会再次出现。

因此后续升级前后建议检查：
<code>grep -Rni "MyISAM" /www/wwwroot/mediawiki-1.45.3/sql</code>
如果已经升级到新目录，例如：
<code>/www/wwwroot/mediawiki-1.46.x/</code>
则需要改成对应的新路径：
<code>grep -Rni "MyISAM" /www/wwwroot/mediawiki-1.46.x/sql</code>
如果发现新的安装或升级 SQL 中仍然存在：
<code>ENGINE = MyISAM</code>
就需要再次评估是否替换为：
<code>ENGINE = InnoDB</code>
另外，升级 MediaWiki 后通常还需要运行维护脚本：
<code>cd /www/wwwroot/mediawiki-1.45.3
php maintenance/run.php update</code>
升级后也建议再次检查表引擎：
<code>SELECT TABLE_NAME, ENGINE
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'mediawiki'
AND ENGINE = 'MyISAM';</code>

== 总结 ==
这次问题的根本原因不是 MediaWiki 数据库连接失败，也不是用户权限错误，而是：
<code>云服务商托管 MySQL 禁用了 MyISAM 存储引擎，而 MediaWiki 安装 SQL 中仍然存在 MyISAM 建表语句。</code>
解决思路是：

# 备份 MediaWiki 的 MySQL 建表 SQL 文件；
# 将 <code>ENGINE = MyISAM</code> 替换为 <code>ENGINE = InnoDB</code>；
# 清空安装失败后残留的数据库；
# 重新运行 MediaWiki 安装程序；
# 安装完成后检查所有表是否都是 InnoDB；
# 后续升级 MediaWiki 时重新检查 SQL 文件，避免 MyISAM 建表语句再次出现。

对于使用 Oracle Cloud MySQL、阿里云 RDS、腾讯云数据库、AWS RDS 等云服务商数据库系统的用户来说，这类问题并不罕见。云数据库通常更偏向稳定、安全和统一管理，因此会禁用一些旧式或不推荐的特性。安装传统 PHP 程序时，如果遇到类似报错，应优先检查程序的建表 SQL 是否使用了云数据库不支持的存储引擎。

安装MediaWiki时遇到MyISAM被禁用 - 版本历史

2026年6月10日 (三) 22:01 Doge24190

2026年6月10日 (三) 21:42 Doge24190