遇到 pbootCMS 后台登录提示数据库连接失败，最直接的處理方向是檢查數據庫配置文件與服務狀態，適用於大多數因配置變動或服務異常導致的場景。

快速处理思路

如果不方便逐步排查，可按照以下顺序快速过一遍常见故障点：

1. 登录服务器，检查 MySQL 服务状态。
2. 备份并找到站点目录下的配置文件，核对数据库连接信息。
3. 确认 PHP 环境是否加载了必要的数据库扩展。

为什么会这样

pbootCMS 基于 PHP 开发，后台登录时需要读取配置文件中的数据库信息来连接 MySQL。当配置文件中的信息与实际数据库不一致，或者数据库服务本身停止运行，PHP 脚本就无法建立连接，从而抛出连接失败错误。此外，服务器迁移、数据库密码修改、文件权限变动都可能导致原本正常的站点出现此问题。

分步处理

请按顺序执行以下操作，每步完成后观察是否有变化：

1. 检查数据库服务状态

首先确保数据库软件正在运行。在 Linux 服务器上执行（需要 root 或 sudo 权限）：

sudo systemctl status mysqld

如果显示 inactive 或 failed，尝试启动服务：

sudo systemctl start mysqld

如果是 Windows 服务器，请在服务管理器中查看 MySQL 服务是否正在运行。

2. 核对配置文件信息

重要：修改前请先备份原文件，防止语法错误导致网站无法访问。

cp config/config.php config/config.php.bak

进入网站根目录，找到配置文件。pbootCMS 的数据库配置通常位于 config/config.php 或 data/config.php（具体路径视版本和安装方式而定）。使用编辑器打开，检查以下字段结构（参考示例）：

return [
    'database' => [
        'host' => '127.0.0.1',
        'user' => 'root',
        'password' => 'your_password',
        'dbname' => 'pbootcms',
        'prefix' => 'ay_'
    ]
];

重点核对 host、user、password、dbname 及 prefix 是否与实际情况一致。修改后保存文件，注意不要破坏 PHP 语法结构。

同时检查文件权限，确保 Web 服务器用户有读取权限：

chmod 644 config/config.php
chown www:www config/config.php

注：用户组 www 可能因环境不同为 www-data 或 nginx，请根据实际情况调整。

3. 检查 PHP 扩展

确保 PHP 环境支持数据库连接。创建一个新的 phpinfo 页面或在命令行执行：

php -m | grep -i mysql

确认是否有 pdo_mysql 或 mysqli 扩展。如果没有，需要联系主机商或自行安装对应扩展。

怎么验证是否生效

完成上述调整后，无需重启 Web 服务，直接刷新后台登录页面。

• 如果不再提示数据库连接失败，而是显示登录表单或提示账号密码错误，说明数据库连接已恢复。
• 如果仍然报错，查看网站运行日志。pbootCMS 通常在 runtime/log 或根目录下的错误日志文件中记录详细报错信息。
• 可使用命令实时查看日志：tail -f runtime/log/index.html（具体日志文件名可能不同）。

常见坑

• 密码特殊字符：数据库密码中包含特殊字符时，在配置文件中可能需要转义，或直接修改数据库密码为纯字母数字测试。
• 主机名 localhost：在某些环境下，localhost 可能指向 socket 连接，而 127.0.0.1 指向 TCP 连接，如果不确定可尝试互换测试。
• 缓存干扰：部分服务器开启了 OPcache 或文件缓存，修改配置文件后可能未生效，尝试重启 PHP 服务或清除 OPcache。
• 远程数据库：如果数据库不在本地，确保防火墙已放行 3306 端口，且数据库用户允许远程连接。