CodeIgniter数据库连接测试技巧

本文详解了CodeIgniter 4数据库连接配置与测试的核心要点，直击开发者最常踩坑的三大痛点：环境变量必须通过`.env`文件配置且需确保`APP_ENV=development`才能生效、特殊字符密码必须URL编码、Docker等场景下`localhost`需替换为正确主机地址；强调用`service('database')->query('SELECT 1')`进行轻量快速连通性验证，并指出注释格式、引号包裹空格值、重启服务等易忽略细节，同时推荐使用独立CLI脚本绕过框架干扰，精准定位是环境配置问题还是真实数据库故障。

数据库配置写在哪、怎么写才生效

CodeIgniter 4 的数据库配置不在 application/config/database.php，那是 CI3 的老路子。CI4 默认用 .env 文件配数据库，改完还得确保 APP_ENV 不是 production（否则会忽略 .env）。

• APP_ENV=development 必须设对，否则 .env 读不进配置
• database.default.hostname 等键名不能手敲，得用 DATABASE_HOST 这类环境变量名，CI4 自动映射
• 密码含特殊字符（比如 @ 或 /）必须 URL 编码，否则 parse_url() 解析失败，连上但查不出数据
• MySQL 端口默认是 3306，显式写 DATABASE_PORT=3306 更稳妥，Docker 环境常被映射到其他端口

用 $db->query() 测试连通性最直接

别急着跑 Migration 或 Model，先拿原生查询确认底层通不通。CI4 的 Database 实例默认已初始化，service('database') 就能拿到，比写完整连接逻辑快得多。

• 执行 $db = service('database'); $db->query('SELECT 1')->getRow();，返回对象说明连接成功
• 如果报错 Connection refused，八成是 DATABASE_HOST 写成了 localhost（Docker 容器里要改成宿主机 IP 或 host.docker.internal）
• 报 Access denied 优先检查 DATABASE_USERNAME 和 DATABASE_PASSWORD 是否和 MySQL 实际账号一致，CI4 不做密码自动加盐或转换
• 返回 null 但无报错？可能是数据库名填错，或者该库下真没表——CI4 不强制要求库存在才允许连接

CI4 的 .env 里注释掉的配置项会生效吗

不会。CI4 的 DotEnv 解析器严格按行处理，以 # 开头的整行都被跳过，哪怕你只注释掉半行，比如 DATABASE_HOST=#127.0.0.1，它会把值解析成字面量 #127.0.0.1，然后连到一个叫 “#127.0.0.1” 的主机上，当然失败。

• 注释必须独占一行，且以 # 开头，后面紧跟空格再写说明
• 环境变量值带空格必须用单引号或双引号包裹，比如 DATABASE_NAME='my app'
• 修改 .env 后必须重启 CLI 或 Web 服务，PHP 不会热重载环境变量
• 部署时若用 php spark serve，记得加 --env=production 参数，否则还是读本地 .env

测试脚本放哪、怎么避免被路由干扰

别塞进 Controller 或写成路由可访问的页面。最干净的做法是新建一个独立 PHP 脚本，比如 tests/db_test.php，用 CLI 直接运行：php tests/db_test.php。这样绕过所有框架生命周期，只测数据库层。

• 脚本开头必须手动引入 bootstrap.php，例如 require __DIR__.'/../public/index.php'; 是错的，得用 require __DIR__.'/../vendor/codeigniter4/framework/system/Bootstrap.php';
• 推荐用 require_once FCPATH . '../vendor/autoload.php'; + 手动初始化 Config\Database，更轻量
• Web 访问测试页容易触发 CSRF 验证或中间件，导致“连得上但返回 403”，误判为数据库问题
• CLI 下报错信息更全，比如 PDO 构造失败时会明确提示 SQLSTATE[HY000] [2002] 还是 [1045]，比浏览器里看白屏有用得多

环境变量拼写错误、Docker 网络隔离、特殊字符未编码——这三个点卡住的人最多，而且报错信息看起来都像数据库问题，其实跟 DB 本身无关。

本篇关于《CodeIgniter数据库连接测试技巧》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！