为Apex应用终端用户添加登录页密码修改/重置功能及相关异常问题排查

针对你遇到的在Apex登录页添加密码修改功能时的两个异常，我给你整理了完整的解决方案，先从基础配置补全，再针对性解决问题：

一、先补全密码修改功能的正确配置步骤 #

如果之前的配置有遗漏，可以按这个流程走：

1. 创建密码修改专用页面
   • 在应用 builder 里新建页面，选择「Form on Table or View」，绑定到你的用户表（如果用Apex自带的用户系统就选APEX_USERS，自定义用户表就选你自己的表）。
   • 页面上至少要包含：用户名输入项、旧密码输入项、新密码输入项、确认新密码输入项，以及「修改密码」按钮。
2. 在登录页添加入口
   • 编辑登录页面，在登录表单区域下方添加一个文本链接或按钮，比如「修改密码」，设置跳转目标为刚创建的密码修改页面，同时把登录页的用户名项值传递过去（比如在跳转URL里加&PXX_USERNAME=&P101_USERNAME.，这里P101是登录页编号，PXX是密码修改页编号）。

二、解决你遇到的两个异常问题 #

1. 未输入用户名时仍可进入密码修改页面 #

这个问题是因为没有对密码修改页面的访问做前置验证，解决方法有两种：

• 方法一：限制登录页的入口按钮
  编辑登录页的「修改密码」按钮，添加服务器端条件：当登录页的用户名输入项（比如P101_USERNAME）不为空时才显示该按钮。这样用户没输入用户名就看不到入口，自然无法进入。
• 方法二：在密码修改页面添加前置拦截
  即使用户通过其他方式进入密码修改页，也直接拦截重定向：
  1. 打开密码修改页面的「Page Processing」，添加一个Before Header类型的流程。
  2. 选择「Execute PL/SQL Code」，输入以下代码（替换XX为你的密码修改页编号）：

     IF :PXX_USERNAME IS NULL THEN
         -- 重定向回登录页
         APEX_UTIL.REDIRECT_URL('f?p='||:APP_ID||':LOGIN:'||:APP_SESSION);
         -- 终止后续页面加载
         APEX_APPLICATION.STOP_APEX_ENGINE;
     END IF;
     

  这样只要用户名项为空，用户就会被直接送回登录页。

2. 点击「修改密码」按钮后弹出内部错误 #

内部错误通常是因为PL/SQL逻辑报错但没捕获异常，或者权限/字段绑定有问题，按以下步骤排查解决：

• 第一步：查看具体错误信息
  先去「Shared Components」→「Application Error Logs」里找到对应的错误记录，里面会有详细的报错堆栈，比如是密码验证失败、权限不足还是字段为空报错，这是解决问题的关键。
• 第二步：修复修改密码的核心逻辑
  推荐使用Apex内置的APEX_UTIL.CHANGE_PASSWORD过程来修改密码，它自带验证和权限处理，比直接更新表更安全：
  1. 在密码修改页面的「修改密码」按钮对应的流程里，选择「Execute PL/SQL Code」，输入以下代码（替换XX为你的页面编号）：

     BEGIN
         APEX_UTIL.CHANGE_PASSWORD(
             p_user_name => :PXX_USERNAME,
             p_old_password => :PXX_OLD_PASSWORD,
             p_new_password => :PXX_NEW_PASSWORD
         );
         -- 设置成功消息
         APEX_APPLICATION.SET_SESSION_STATE('PXX_SUCCESS_MSG', '密码修改成功，请重新登录！');
         -- 重定向回登录页
         APEX_UTIL.REDIRECT_URL('f?p='||:APP_ID||':LOGIN:'||:APP_SESSION);
     EXCEPTION
         WHEN OTHERS THEN
             -- 捕获异常并显示具体错误
             APEX_APPLICATION.SET_SESSION_STATE('PXX_ERROR_MSG', '修改失败：' || SQLERRM);
     END;
     

  2. 在页面上创建两个文本项PXX_SUCCESS_MSG和PXX_ERROR_MSG，设置它们的类型为「Display Only」，用来显示成功或错误信息，这样用户就能看到具体问题，而不是模糊的内部错误。
• 第三步：添加客户端验证
  在密码修改页面添加验证规则，比如：
  • 旧密码、新密码、确认新密码不能为空；
  • 新密码和确认密码必须一致；
  • 新密码符合复杂度要求（比如长度≥8，包含大小写和特殊字符）。
    这些验证可以用Apex的「Validation」功能实现，在用户点击按钮前就拦截错误，避免触发服务器端异常。

三、额外优化建议 #

如果需要拓展到重置密码（忘记密码无需旧密码），可以添加以下流程：

1. 在登录页添加「忘记密码」入口，跳转到一个新页面，让用户输入用户名/邮箱；
2. 调用APEX_UTIL.SEND_EMAIL发送包含重置链接的邮件，链接里带唯一的验证令牌；
3. 用户点击链接后进入重置页面，验证令牌有效后允许设置新密码。

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