ThinkPHP CLI模式下数据库配置不生效，因默认跳过.env加载，需在think入口末尾手动调用Dotenv::createImmutable(__DIR__)->safeLoad()，并确保执行路径为项目根目录、清除runtime缓存、检查CLI专属php.ini中pdo_mysql扩展是否启用。
ThinkPHP 数据库配置在 CLI 模式下不生效，不是配置写错了，而是环境加载机制本身不同——Web 请求自动读 .env 并初始化数据库连接，CLI 下默认跳过这一步，所有配置都得手动“唤醒”。
CLI 不自动加载 .env 文件
框架设计上明确区分上下文：Web 环境从根目录自动载入 .env；CLI 启动路径不确定（比如 cron 从 /var/spool/cron 执行），为避免误判，干脆不加载。结果就是 DB_HOST、DB_PORT 等变量全为空，连接仍用默认值 127.0.0.1:3306，密码为空。
- 验证方法：在命令入口（如 think 或 cli.php）开头加
var_dump(getenv('DB_HOST'));，输出 false 就确认没加载 - 修复方式：在入口文件末尾手动加载，例如：
if (PHP_SAPI === 'cli') {<br> Dotenv\Dotenv::createImmutable(__DIR__)->safeLoad();<br> } - ThinkPHP 6.1+ 若用了
topthink/think-env，仍需显式调用Env::load()，不能依赖 config/app.php 中的env_file配置
工作目录错位导致路径解析失败
.env 路径是相对 __DIR__ 解析的，而 CLI 执行时当前工作目录可能不是项目根目录。比如 cron 直接执行 php /path/to/think command:run，但没先 cd 进去，__DIR__ 就指向 /path/to/，.env 却在 /path/to/project/.env。
- 定时任务必须带 cd 切换：
* * * * * cd /var/www/myapp && php think schedule:run - 或直接用绝对路径加载：
$dotenv = Dotenv\Dotenv::createImmutable('/var/www/myapp'); - 检查当前路径是否正确：在命令 handle() 中加
echo getcwd();输出实际工作目录
数据库配置被缓存或未刷新
ThinkPHP 启动时会缓存配置（runtime/cache/ 下的 config.php），如果 .env 修改后没清缓存，CLI 仍读旧值；更隐蔽的是，CLI 和 Web 可能共用同一缓存目录，但 Web 环境先生成了缓存，CLI 就绕过 .env 直接读缓存。
立即学习“PHP免费学习笔记（深入）”；
- 每次改 .env 后，务必清空
runtime/cache/和runtime/config/ - 开发期可临时关闭配置缓存：在 app.php 中设
'config_cache' => false - CLI 命令中不要依赖 Config::get() 的“延迟加载”，应主动触发
Config::load()确保最新
扩展缺失只暴露在 CLI 环境
pdo_mysql 在 Web 环境已启用，但 CLI 下没开——因为 Apache/Nginx 和命令行用的是两套 php.ini。常见现象：网页能连库，定时任务报 “could not find driver”。
- 终端运行
php -m | grep pdo_mysql，无输出就说明 CLI 缺扩展 - 对比 Web 环境：访问 phpinfo() 页面，记下 “Loaded Configuration File”，再检查该 php.ini 是否有
extension=pdo_mysql.so（Linux/macOS）或extension=php_pdo_mysql.dll（Windows） - 别忘了重启 PHP-FPM 或 Apache，让 Web 端配置生效
