Oracle APEX 5.1自定义认证方案：如何阻止用户名默认转大写？

安全阿岳

2026-5-15

嘿，这个问题我之前在APEX 5.1里也碰到过！默认的大写转换确实挺烦人的，尤其是当你的系统需要区分用户名大小写的时候。下面是几个能解决这个问题的关键步骤，按顺序来试就行：

1. 调整认证方案的用户名转换设置

这是最直接的地方。打开你的自定义认证方案编辑页面，找到用户名转换这个选项——默认它可能被设成了「转换为大写」，直接改成「不转换」就好。这个设置会告诉APEX不要自动对输入的用户名做大小写转换，直接传递原始值给你的认证逻辑。

2. 检查自定义认证函数的代码

如果你的认证方案用了自定义PL/SQL函数，一定要检查里面有没有手动调用UPPER()的地方。比如很多人一开始会写：

FUNCTION my_auth_function (p_username IN VARCHAR2, p_password IN VARCHAR2) RETURN BOOLEAN IS
BEGIN
  SELECT 1
    FROM users
   WHERE username = UPPER(p_username)
     AND password_hash = my_hash_function(p_password);
  RETURN TRUE;
EXCEPTION
  WHEN NO_DATA_FOUND THEN
    RETURN FALSE;
END;

这里的UPPER(p_username)就是罪魁祸首，把它去掉，直接用p_username就行：

WHERE username = p_username

当然，前提是你的users表中存储的用户名是区分大小写的（比如你存的是「JohnDoe」而不是「JOHNDOE」）。

3. 确认登录页面项的转换设置

有时候问题出在登录页面的输入项上。打开你的登录页面，找到用户名对应的页面项（比如P1_USERNAME），编辑它的属性。在「转换」部分，看看有没有设置成「大写」——如果有的话，改成「无」，这样输入的内容就会原封不动地提交。

4. 数据库层面的大小写兼容（可选）

如果你的Oracle数据库默认是不区分大小写的（这是默认行为），即使上面的步骤都做了，查询的时候可能还是会匹配到大小写不同的用户名。这时候你需要确保查询是精确匹配的。可以用两种方式：

用DBMS_UTILITY.COMPARE_STRING函数来做精确的大小写比较：
```
WHERE DBMS_UTILITY.COMPARE_STRING(username, p_username) = 0
```
如果你用的是Oracle 12c及以上版本，可以给username字段设置区分大小写的排序规则：
```
ALTER TABLE users MODIFY username VARCHAR2(50) COLLATE BINARY_CS;
```
这样后续的=比较就会严格区分大小写了。

最后提醒一下：如果之前系统里的用户都是以大写存储的，修改后要考虑兼容问题——要么让老用户用原来的大写用户名登录，要么批量更新用户表的用户名到正确的大小写。

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