CodeIgniter 4登录表单验证错误不显示及URI异常问题排查

核心问题分析 #

提交空用户名时验证逻辑触发但无错误提示、URI跳转到index.php，本质是验证错误未正确传递到视图+表单提交路径/路由配置错误导致的。以下是具体排查和修复步骤：

1. 检查视图错误输出逻辑 #

CodeIgniter 4 不会自动渲染错误信息，需手动在视图中调用验证方法：

• 方式1：输出所有错误（全局提示）

<?php if (session()->has('errors')) : ?>
    <div class="alert alert-danger">
        <?= implode('<br>', session('errors')) ?>
    </div>
<?php endif; ?>

• 方式2：输出单个字段错误（对应到输入框下方）

<input type="text" name="username" value="<?= old('username') ?>">
<?php if (isset($validation) && $validation->hasError('username')) : ?>
    <span class="text-danger"><?= $validation->getError('username') ?></span>
<?php endif; ?>

注意：不要用CodeIgniter 3的form_error()方法，CI4已废弃。

2. 修正控制器验证失败后的返回逻辑 #

验证失败时禁止用跳转（redirect()），跳转会清空会话中的验证错误，必须直接返回登录视图：

public function processLogin()
{
    $validation = \Config\Services::validation();
    $validation->setRules([
        'username' => 'required|trim',
        'password' => 'required'
    ]);

    if (!$validation->run($this->request->getPost())) {
        // 直接返回视图，传递验证实例+保留用户输入
        return view('auth/login', [
            'validation' => $validation
        ]);
    }

    // 验证成功后的登录逻辑
    // ...
}

如果必须跳转（不推荐），需手动存入错误信息：

return redirect()->back()->withInput()->with('errors', $validation->getErrors());

3. 修复表单提交路径 #

确保表单action指向正确的控制器处理方法，避免跳转到根路由：

<form method="post" action="<?= site_url('auth/processLogin') ?>">
    <!-- CSRF令牌（开启CSRF保护时必须加） -->
    <?= csrf_field() ?>
    
    <!-- 表单字段 -->
    <!-- ... -->
</form>

不要将action设为空或index.php，否则会默认提交到当前域名根路径。

4. 检查路由配置 #

在app/Config/Routes.php中确保登录相关的GET/POST路由正确配置：

// 登录页面展示
$routes->get('/login', 'AuthController::login');
// 登录请求处理
$routes->post('/login/process', 'AuthController::processLogin');

如果未配置POST路由，表单提交时会匹配默认路由规则，导致URI跳转到index.php。

5. 验证会话配置 #

CI4的错误信息依赖会话存储，检查app/Config/App.php中的会话配置是否正常：

public $sessionDriver = 'CodeIgniter\Session\Handlers\FileHandler';
public $sessionCookieName = 'ci_session';
public $sessionExpiration = 7200;
public $sessionSavePath = WRITEPATH . 'session';
public $sessionMatchIP = false;
public $sessionTimeToUpdate = 300;
public $sessionRegenerateDestroy = false;

确保sessionSavePath目录存在且有读写权限。

内容的提问来源于stack exchange，提问作者AnharGP