访问 Synology WordPress 数据库连接错误？全流程排查与修复教程

• 间歇性错误：有时能正常访问，有时弹出错误，多为 MariaDB 服务不稳定（如内存不足导致服务频繁重启）或 NAS 网络波动；

• 仅后台错误：前台能加载静态内容（如首页图片），但后台登录失败，多为数据库用户仅拥有 “读取” 权限，无 “写入” 权限（后台操作需写入数据）；

• 升级后错误：更新 WordPress 版本、MariaDB 版本或 DSM 系统后出现错误，多为版本兼容性问题（如 PHP 版本过高导致数据库驱动失效）。

1. 登录 Synology DSM 桌面：打开浏览器输入 NAS 的局域网 IP（如 192.168.1.10），输入管理员账号密码；

2. 进入 MariaDB 套件管理：点击桌面「套件中心」→「已安装」，在列表中找到 “MariaDB 10”（或 “MariaDB 5”，根据安装版本选择）；

3. 查看并启动服务：

• • 若 “状态” 显示 “已停止”，点击右侧「启动」按钮，等待 10-20 秒（服务启动需时间），状态变为 “运行中”；

• • 若点击「启动」后立即变回 “已停止”，说明 MariaDB 服务异常（如配置文件损坏），需进入下一步：点击「设置」→「日志」，查看错误原因（如 “无法读取配置文件 my.cnf”），需重新安装 MariaDB（先卸载再从套件中心重装，注意：卸载前需备份数据库）；

4. 验证服务是否正常：打开「资源监视器」→「服务」标签页，找到 “mariadb10”（或 “mariadb”），确认 “状态” 为 “运行中”，“CPU / 内存” 有正常占用（如内存占用 50-200MB）。

1. 定位 wp-config.php 文件：

• • 打开 DSM「文件管理器」，进入 WordPress 安装目录（默认路径：web/wordpress，若自定义过路径，需进入对应目录）；

• • 在目录中找到wp-config.php文件（名称固定，区分大小写），右键选择「编辑」（需确保当前用户有 “写入” 权限，管理员账户默认有权限）；

2. 核对 4 个核心参数（参数需与 MariaDB 中的实际配置完全一致）：

// 1. 数据库名称（需与phpMyAdmin中创建的数据库名称一致，区分大小写）define( 'DB_NAME', 'wp_database' );// 2. 数据库用户名（需与数据库绑定的用户一致，如wp_user）define( 'DB_USER', 'wp_user' );// 3. 数据库密码（需与用户密码完全一致，含特殊符号需保留原格式，不可遗漏引号）define( 'DB_PASSWORD', 'YourComplexPassword123!' );// 4. 数据库主机（Synology MariaDB默认主机为localhost，不可改为NAS IP，除非手动修改过MariaDB配置）define( 'DB_HOST', 'localhost' );

关键提醒：① 密码若含$、&等特殊符号，需确保在引号内（如'P@ssw0rd$'），否则会被 PHP 解析为变量；② DB_HOST 必须为localhost，填 NAS IP（如 192.168.1.10）会导致连接失败；

3. 保存并验证：修改参数后点击「保存」，关闭文件管理器，重新访问 WordPress 前台，若能正常加载，说明配置错误已修复；若仍报错，进入下一步。

1. 登录 phpMyAdmin：

• • 打开 DSM 桌面「phpMyAdmin」，输入 MariaDB 的 “root” 用户名和密码（默认密码在 MariaDB「设置→数据库」中查看；若未设置，需先在 MariaDB 套件中设置 root 密码）；

2. 定位 WordPress 数据库与用户：

• • 左侧菜单栏选择 WordPress 对应的数据库（如wp_database，与 wp-config.php 中的 DB_NAME 一致）；

• • 点击顶部「权限」标签页，在 “用户账户” 列表中找到对应的数据库用户（如wp_user，与 DB_USER 一致）；

3. 检查并添加权限：

• • 点击用户右侧的「编辑权限」，在 “数据库特定权限” 中，确保以下权限已勾选：

• • • 数据权限：SELECT（查询）、INSERT（插入）、UPDATE（更新）、DELETE（删除）；

• • • 结构权限：CREATE（创建表）、ALTER（修改表）、DROP（删除表）；

• • 若权限缺失，勾选对应权限，点击底部「执行」保存；

4. 验证权限：重新访问 WordPress，若能正常登录后台并编辑文章，说明权限问题已解决。

1. 登录 phpMyAdmin 并选择数据库：左侧选择 WordPress 数据库（如wp_database）；

2. 选择所有数据库表：

• • 点击顶部「结构」标签页，勾选页面底部的「全选」（选中所有以wp_开头的表，如wp_posts、wp_users）；

3. 执行修复操作：

• • 在 “_WITH SELECTED” 下拉菜单中选择「修复表」，phpMyAdmin 会自动检测并修复损坏的表；

• • 修复完成后，页面会显示 “OK” 或 “修复成功”（若显示 “无法修复”，需从备份恢复数据库，见步骤 5）；

4. 验证修复效果：重新访问 WordPress，若错误消失，说明数据库已修复；若仍报错，需进行下一步。

1. 查看 WordPress 推荐 PHP 版本：

• • 登录 WordPress 官网（https://wordpress.org/support/requirements/），查看当前 WordPress 版本推荐的 PHP 版本（如 WordPress 6.4 推荐 PHP 7.4-8.2）；

2. 调整 Web Station 中的 PHP 版本：

• • 打开 DSM「Web Station」→「虚拟主机」，找到 WordPress 对应的虚拟主机（若未创建，需先创建：点击「创建」，选择 HTTP/HTTPS，文档根目录设为web/wordpress）；

• • 点击虚拟主机右侧「编辑」→「PHP 设置」，在 “PHP 版本” 下拉菜单中选择与 WordPress 兼容的版本（如 PHP 8.0）；

• • 点击「确定」，等待配置生效（约 10 秒）；

3. 验证兼容性：重新访问 WordPress，若能正常加载，说明版本适配成功。

• 原因：DB_NAME 参数错误（数据库名称不存在），或数据库已被误删除；

• 解决：① 登录 phpMyAdmin，左侧菜单栏查看是否有与 DB_NAME 一致的数据库，若没有，需重新创建（点击「新建」，输入数据库名， collation 选utf8mb4_unicode_ci）；② 核对 wp-config.php 中的 DB_NAME，确保与新建的数据库名完全一致（区分大小写）。

• 原因：root 密码错误，或 root 用户被限制本地访问；

• 解决：① 进入 MariaDB 套件「设置→数据库」，点击「重置 root 密码」，设置新密码；② 重新登录 phpMyAdmin，输入新密码；③ 若仍拒绝，在 MariaDB「设置→高级设置」中，勾选 “允许 root 用户远程访问”（仅临时测试，测试后关闭，避免安全风险）。

• 原因：数据库表损坏严重（如磁盘坏道导致数据块丢失）；

• 解决：① 从备份恢复：若之前用 Synology「Hyper Backup」备份过数据库，进入「Hyper Backup→恢复」，选择最近的备份点，仅恢复数据库；② 重新安装 WordPress：删除原 WordPress 目录和数据库，重新从套件中心安装 WordPress，安装时会自动创建新数据库（需重新导入文章数据，可从 WordPress 后台导出的 XML 备份中恢复）。

1. 定期备份数据库：

• • 用 Synology「Hyper Backup」创建数据库备份任务：进入「Hyper Backup→创建」，选择 “数据备份”，勾选 “MariaDB”，设置备份频率（如每日备份），保存到 NAS 的其他存储池或外接硬盘；

• • 同时在 WordPress 后台导出内容备份：进入「工具→导出」，选择 “所有内容”，导出 XML 文件，保存到本地。

2. 稳定 MariaDB 服务：

• • 避免 NAS 内存不足：关闭不必要的套件（如 Video Station、Download Station），若 NAS 支持扩展内存（如 DS923+），升级内存到 4GB+；

• • 启用 MariaDB 自动启动：进入 MariaDB 套件「设置→高级设置」，勾选 “DSM 启动时自动启动 MariaDB”，避免 NAS 重启后服务未启动。

3. 谨慎修改配置与版本：

• • 不随意修改 wp-config.php 参数：修改前先备份文件（右键「复制」，重命名为wp-config-backup.php）；

• • 升级版本前测试兼容性：更新 WordPress、MariaDB 或 PHP 版本前，先在本地测试环境（如电脑上的 XAMPP）验证兼容性，无问题后再在 NAS 上升级。

4. 监控硬盘健康状态：

• • 定期查看 DSM「存储管理器→硬盘」，检查硬盘 “健康状态” 是否为 “正常”，若显示 “警告” 或 “不良”，及时更换硬盘（避免磁盘错误导致数据库损坏）。