codeigniter 4 数据库配置写在 .env 文件中，需设 app_env=development 才生效，使用 database_host 等环境变量名，特殊字符须 url 编码，端口建议显式声明，测试用 service('database')->query('select 1')。
数据库配置写在哪、怎么写才生效
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 本身无关。
