数据库配置缺失或解析失败的典型表现是框架初始化时未获取到hostname键，需检查config/database.php中是否真实存在'hostname'=>env('db_host','127.0.0.1')、.env格式是否规范、环境变量是否生效及多应用配置干扰。
这是数据库配置缺失或解析失败的典型表现，不是代码写错了，而是框架在初始化连接时根本没拿到 hostname 这个键——它在配置数组里压根不存在。
先确认 config/database.php 是否真有 hostname 配置
打开 config/database.php，检查 'connections' => ['mysql' => [...]] 里是否明确写了：'hostname' => env('DB_HOST', '127.0.0.1'),
别只看注释或默认值，要确认这行代码真实存在且没被注释掉。常见错误是复制模板时漏掉这一项，或误写成 host、server 等非标准键名。
检查 .env 文件是否干扰了配置加载
TP5.1 用 phpdotenv 解析 .env，而它对格式极其敏感：
- 确保
DB_HOST=127.0.0.1这类行末没有空格或制表符 - 若值含
#、$、空格等特殊字符（如DB_PASSWORD=pass#123），必须用双引号包裹：DB_PASSWORD="pass#123" - 单引号无效，
DB_HOST='127.0.0.1'会导致解析失败，hostname变成空字符串甚至 null
验证环境变量是否真正生效
在控制器开头加一行临时调试代码：dump(env('DB_HOST')); exit;
如果输出 null 或空白，说明 .env 没加载成功。此时需检查：
- 项目根目录下是否存在
.env文件（注意 Linux 下不可是.env.txt） -
thinkphp/library/think/Env.php的load()方法是否被跳过（比如被自定义入口逻辑绕过） - 运行时缓存是否固化了旧配置：删掉
runtime/config/整个目录再试
排除多应用或自定义配置路径干扰
如果你用了多应用模式或重写了配置加载逻辑：
- 确认当前请求走的是哪个应用，
config/database.php是不是改错了位置（比如改了app/database.php却没启用该文件） - 检查是否有中间件或服务提供者提前调用了数据库操作，导致在配置完全载入前就触发了连接初始化
- 搜索项目中是否手动调用了
Db::connect()并传入了不完整的配置数组
