控制器不应写数据库操作，否则验证后数据丢失；Model需显式返回插入ID；路由须在Routes.php定义；模型必须声明$table和$primaryKey；调试需开启日志并检查错误。
控制器里别写数据库操作，否则 $this->validate() 之后的数据就丢了
新手常把表单验证、数据入库、跳转逻辑全塞进一个 register() 方法里，结果发现验证通过后查不到刚插入的用户ID。根本原因是 CI4 的 Model 默认不自动返回插入 ID，而你又没显式调用 $model->getInsertID()。
正确做法是把数据处理下沉到 Model 或专用服务类：
-
Controller只负责接收请求、调用验证、转发结果 -
Model封装insert()、update()、find()等原子操作，并确保返回值明确（比如插入后必须 return $this->db->insertID()） - 复杂流程（如注册+发邮件+初始化配置）用
UserService这类服务类协调，别让控制器变“胶水代码”
app/Views/ 里的文件不能直接访问，路径和命名必须匹配路由规则
很多新手建了 app/Views/auth/register.php，然后在浏览器里输 /auth/register —— 404。CI4 不是“文件即路由”，而是靠 app/Config/Routes.php 显式定义。
常见错法与对应解法：
- 写了视图但没在路由里映射：
$routes->get('register', 'Auth::register');缺失 → 补上 - 视图名带下划线（如
user_profile.php），但控制器方法叫userProfile()→ CI4 默认启用驼峰转换，视图会自动找userProfile.php，不是user_profile.php - 在视图里用
base_url()加载 CSS 却没配app/Config/App.php中的$baseURL→ 浏览器加载 404，要设成实际域名或http://localhost:8080/
模型类名和数据库表名默认不强制绑定，但 $table 属性必须手动指定
CI4 不像 Laravel 那样自动推导复数表名，也不强制模型名 = 表名。如果你建了 UserModel 类，默认它会去找 users 表 —— 仅当类名是复数且无 $table 声明时才生效。一旦你改名成 AccountModel，不设 $table 就会查错表。
安全写法始终显式声明：
class AccountModel extends Model
{
protected $table = 'accounts';
protected $primaryKey = 'id';
}
- 漏设
$table→ 查询account（单数）表，报错Table 'myapp.account' doesn't exist - 漏设
$primaryKey→update()和delete()失效，因为框架不知道用哪个字段做 WHERE 条件 - 表字段含前缀（如
tbl_users）→$table必须写全，不能只写users
调试时别只看页面空白，先开 app/Config/Logger.php 的 debug 级别
CI4 默认生产环境关闭错误显示，新手提交表单失败却看不到任何提示，只看到白屏。这不是代码错了，是日志被压住了。
快速定位问题的三步：
- 把
app/Config/Logger.php里的$threshold = 0;改成$threshold = 4;（DEBUG 级） - 检查
writable/logs/下最新日志文件，重点看CRITICAL和ERROR行 - 验证失败时，
$this->validator->getErrors()返回的是关联数组，不是字符串 —— 直接 echo 会空，得用print_r()或传给视图后foreach输出
最常被忽略的是：模型查询失败时，CI4 默认静默返回 false，不会抛异常。你要主动检查 if ($result === false) 并记录 $model->errors()。
