CodeIgniter登录验证优化：区分用户名不存在与密码错误场景

好问题！返回字符串确实能解决问题，但从代码可维护性、类型安全和语义清晰度的角度来看，有几个更优的方案值得考虑：

1. 使用枚举（Enum） #

枚举是最直观且类型安全的方案，它能明确限定返回值的可能范围，避免拼写错误或无效值的出现。大部分现代编程语言都支持枚举类型，我们可以为登录结果定义专属枚举，模型层返回枚举实例，控制器通过判断枚举类型来返回对应提示。

以PHP为例：

// 定义登录结果枚举
enum LoginResult {
    case Success;
    case UserNotFound;
    case InvalidPassword;
}

// 模型层验证逻辑
public function validateLogin(string $username, string $password): LoginResult {
    $user = $this->getUserByUsername($username);
    if (!$user) {
        return LoginResult::UserNotFound;
    }
    if (!password_verify($password, $user['password'])) {
        return LoginResult::InvalidPassword;
    }
    return LoginResult::Success;
}

// 控制器层处理逻辑
$result = $this->userModel->validateLogin($username, $password);
match($result) {
    LoginResult::UserNotFound => return $this->jsonResponse(['code' => 404, 'msg' => '用户名不存在']),
    LoginResult::InvalidPassword => return $this->jsonResponse(['code' => 401, 'msg' => '密码错误']),
    LoginResult::Success => return $this->jsonResponse(['code' => 200, 'msg' => '登录成功', 'data' => $user]),
};

这种方案的优势是：语义清晰、类型安全、代码可读性高，后期维护时修改或扩展状态非常方便。

2. 返回结构化结果（数组/对象） #

如果你的语言不支持枚举，或者想在返回结果中携带更多信息（比如成功时的用户数据），可以返回一个包含状态标识的结构化数组或对象。

示例（PHP数组实现）：

// 模型层验证逻辑
public function validateLogin(string $username, string $password): array {
    $user = $this->getUserByUsername($username);
    if (!$user) {
        return [
            'status' => 'error',
            'error_code' => 'user_not_found',
            'msg' => '用户名不存在'
        ];
    }
    if (!password_verify($password, $user['password'])) {
        return [
            'status' => 'error',
            'error_code' => 'invalid_password',
            'msg' => '密码错误'
        ];
    }
    return [
        'status' => 'success',
        'data' => $user,
        'msg' => '登录成功'
    ];
}

// 控制器层处理逻辑
$loginResult = $this->userModel->validateLogin($username, $password);
if ($loginResult['status'] === 'error') {
    return $this->jsonResponse($loginResult);
} else {
    // 处理登录成功逻辑，比如生成token等
    return $this->jsonResponse($loginResult);
}

这种方案的优势是灵活性高，无需额外定义类或枚举，能快速适配不同的返回需求。

3. 抛出自定义异常 #

如果你的项目业务逻辑较为复杂，希望将错误处理与核心业务逻辑解耦，可以考虑在模型层抛出不同的自定义异常，控制器层通过捕获异常类型来返回对应提示。

示例（PHP）：

// 定义自定义异常类
class UserNotFoundException extends \Exception {}
class InvalidPasswordException extends \Exception {}

// 模型层验证逻辑
public function validateLogin(string $username, string $password): array {
    $user = $this->getUserByUsername($username);
    if (!$user) {
        throw new UserNotFoundException('用户名不存在');
    }
    if (!password_verify($password, $user['password'])) {
        throw new InvalidPasswordException('密码错误');
    }
    return $user;
}

// 控制器层处理逻辑
try {
    $user = $this->userModel->validateLogin($username, $password);
    return $this->jsonResponse(['code' => 200, 'msg' => '登录成功', 'data' => $user]);
} catch (UserNotFoundException $e) {
    return $this->jsonResponse(['code' => 404, 'msg' => $e->getMessage()]);
} catch (InvalidPasswordException $e) {
    return $this->jsonResponse(['code' => 401, 'msg' => $e->getMessage()]);
}

这种方案的优势是错误处理逻辑与业务逻辑分离，代码结构更清晰，适合中大型项目的长期维护。

方案选择建议 #

• 小型项目或快速开发：优先选择结构化结果，实现简单且灵活；
• 追求类型安全和可读性：优先选择枚举，能有效避免人为错误；
• 中大型复杂项目：优先选择自定义异常，利于代码解耦和长期维护。

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