db_debug = TRUE 仅在 development 环境下生效，且需确保 .env 正确加载（CI4）或 database.php 配置无误（CI3），否则仍只显示笼统错误；真实原因须通过裸连脚本、mysqli_connect_error() 和 MySQL 错误日志定位。
db_debug = TRUE 但页面只显示 A Database Error Occurred
这不是日志没生成，而是 CI 默认把错误拦在了前端展示层——db_debug 为 TRUE 时，框架只输出一个笼统的提示页，不打印底层 MySQL 错误码、SQL 语句或连接失败的具体原因（比如 HY000/2002 或 1045 Access denied）。
真正有用的错误信息其实在 PHP 的错误输出通道里，但被 CI 的异常处理器吞掉了。常见表现：
– 页面只看到 “A Database Error Occurred”，没堆栈
– error_log 里也空空如也
– php.ini 的 log_errors = On 没起作用
- 确认
application/config/database.php中$db['default']['db_debug']确实是TRUE（注意不是字符串"TRUE"） - 检查
ENVIRONMENT常量是否为'development'：只有development模式下db_debug才生效；production下它会被强制忽略 - CI3 默认禁用
display_errors，即使db_debug = TRUE，也要确保 PHP 自身允许错误显示：ini_set('display_errors', 1); ini_set('display_startup_errors', 1);加到index.php开头
想看真实 MySQL 错误，得绕过 CI 的错误包装
CI 的数据库驱动在抛出异常前做了封装，屏蔽了原始错误细节。最直接的办法是写一个裸连测试脚本，跳过整个框架：
<?php
$host = '127.0.0.1'; // 别用 localhost
$user = 'your_db_user';
$pass = 'your_db_pass';
$db = 'your_db_name';
$conn = mysqli_connect($host, $user, $pass, $db);
if (!$conn) {
echo "MySQL error: " . mysqli_connect_error() . " (errno: " . mysqli_connect_errno() . ")";
exit;
}
echo "Connected OK. DB version: " . mysqli_get_server_info($conn);
?>
这个脚本能暴露所有 CI 隐藏的问题：
– mysqli_connect_error() 返回具体错误，比如 Access denied for user 或 Connection refused
– 如果连不上，说明不是 CI 配置问题，而是权限、防火墙、MySQL 服务状态或认证插件（如 caching_sha2_password）不兼容
- Linux 上用
127.0.0.1而非localhost，避免 Unix socket 路径找不到的问题 - 如果裸连报
Client does not support authentication protocol，说明 MySQL 8.0+ 用户用了新认证方式，需执行ALTER USER 'xxx'@'%' IDENTIFIED WITH mysql_native_password BY 'yyy'; - 共享主机（如 Namecheap）要注意数据库名和用户名带 cPanel 前缀，裸连时必须用完整名称（如
abc123_myapp）
CI4 的 .env 配置未生效也会导致 db_debug 失效
CI4 不再读 database.php，而是优先加载 .env。如果 .env 文件存在但没被读取，db_debug 实际值就是默认的 false，你改 database.php 完全无效。
验证方法：在控制器里加一行 var_dump($_ENV['database.default.db_debug'] ?? 'not set');，看输出是不是 string(4) "true"。如果不是，说明 .env 没加载成功。
-
.env必须放在项目根目录（和public/同级），不能放在public/下 - 文件权限不能是 777，CI4 会拒绝读取；推荐
644 - 检查
public/index.php是否调用了DotEnv::createImmutable()，且路径参数指向正确位置 - Apache 下若启用
mod_rewrite但没配好，可能导致index.php没运行，.env自然不加载
生产环境切记关掉 db_debug，但别靠它掩盖问题
把 db_debug = FALSE 或 ENVIRONMENT = 'production' 当成“解决”方案，只是把错误藏起来。真实问题（比如账号无权限、数据库锁死、host 被拒）依然存在，只是用户看不到而已。
CI 报 Unable to connect to your database server using the provided settings，90% 的情况根本没走到框架逻辑——PHP 连接 MySQL 的那一瞬间就失败了。这时候翻 database.php 或查路由毫无意义。
真正该盯住的是裸连结果、MySQL 错误日志（/var/log/mysql/error.log）、以及 mysqli_connect_errno() 返回的具体数字。那些数字比任何文字提示都准。
