宝塔面板一键部署 Discuz 后数据库连接失败，多数情况是配置文件中的数据库密码与实际创建密码不一致，或 PHP 缺少 mysqli 扩展。适用场景为首次安装或环境重置后，修改配置文件前务必备份原文件，防止配置错误导致站点完全不可用。
先说结论：优先核对 config_global.php 中的数据库密码与宝塔数据库列表中的密码是否一致，其次检查 PHP 扩展是否完整。
- 先确认：检查网站配置文件与数据库实际密码
- 先处理：重置数据库密码或修正配置文件
- 再验证：访问论坛首页确认无数据库错误提示
命令速用版
若熟悉命令行，可通过以下命令快速查看配置文件内容并重启 PHP 服务，注意替换实际路径。
cat /www/wwwroot/你的域名/config/config_global.php
bt restart若不便使用命令，直接在宝塔面板“文件”管理器中编辑配置文件，并在“数据库”菜单重置密码。
为什么会这样
一键部署脚本在创建数据库用户时生成随机密码，偶尔会出现配置文件写入滞后或权限同步问题。此外，Discuz 不同版本对 PHP 版本有明确要求，环境不匹配也会导致连接报错。
常见原因包括配置文件中的 dbhost 填写为 localhost 但 MySQL 仅监听 127.0.0.1，或者 PHP 未安装 pdo_mysql 和 mysqli 扩展。公开资料中没有看到可靠的量化数据说明具体故障比例，但密码不一致是最常见因素。
分步处理
按照以下顺序排查，每步操作后观察错误变化。
1. 定位配置文件
进入宝塔面板“文件”，找到网站根目录下的 config/config_global.php 文件。Discuz X3.4 及 X3.5 版本配置路径通常一致。
2. 核对数据库密码
打开配置文件，查找 $_config['db']['1']['dbpw'] 字段。登录宝塔面板“数据库”，找到对应数据库用户，点击“权限”或“重置密码”。将配置文件中的密码修改为与面板中一致的新密码。
3. 检查 PHP 扩展
在宝塔面板“软件商店”中找到当前网站使用的 PHP 版本，点击“设置”->“安装扩展”。确保 mysqli、pdo_mysql 状态为已安装。若未安装，点击安装后重启 PHP。
4. 检查文件权限
确保 config 目录及配置文件具有读取权限。在宝塔“文件”中选中 config 文件夹，点击“权限”，确保所有者为 www，权限设置为 755 或 644。
怎么验证是否生效
完成修改后，刷新论坛首页。若页面正常显示且无“数据库连接错误”提示，则修复成功。
若仍报错，查看日志文件确认具体原因。日志位置通常在 data/log/error_log 或 宝塔面板“网站”->“日志”->“错误日志”。若日志显示 Access denied for user，说明密码仍未匹配；若显示 Unknown column，说明数据库版本或表结构有问题。
常见坑
1. localhost 与 127.0.0.1 区别
部分 MySQL 配置中，localhost 代表通过 socket 文件连接，127.0.0.1 代表通过 TCP 连接。若配置文件写 localhost 但 MySQL 禁用了 socket，会连接失败。建议统一尝试修改为 127.0.0.1 测试。
2. PHP 版本兼容性
Discuz X3.4 官方推荐 PHP 7.2-7.4，X3.5 支持 PHP 8.0。若使用过高版本 PHP，部分旧函数可能被废弃导致连接脚本出错。建议根据 Discuz 版本选择对应 PHP 版本。
3. 安装锁文件
若数据库连接修复后页面仍跳转安装向导，检查 data/install.lock 文件是否存在。若存在则跳过安装，若不存在但已安装过，可能需手动创建该文件。
常见问题
重置数据库密码后还需要改配置文件吗？
需要。宝塔面板重置密码只会修改数据库端的凭证，网站配置文件中的密码不会自动同步，必须手动修改 config_global.php 保持一致。
为什么提示“没有安装 Discuz”？
这通常不是数据库连接问题，而是安装锁文件缺失。检查 data 目录下是否有 install.lock 文件，若没有且确认已安装完成，手动创建一个空文件即可。
PHP 扩展安装后需要重启服务器吗？
不需要重启服务器，但必须重启 PHP 服务。在宝塔面板 PHP 管理页面点击“重启”即可生效，否则扩展加载不进去。
参考来源
- 宝塔面板官方文档 - 数据库管理页面说明
- Discuz! 官方文档 - 安装指南与环境要求 (https://www.discuz.net/forum.php)