Oracle APEX邮件仅入队列未发送，重置密码功能配置排查求助

1. 补全SMTP服务器核心配置 #

进入【管理实例】→【实例设置】→【邮件】，确认所有必填项配置正确：

• SMTP主机地址：比如Gmail对应smtp.gmail.com，不能留空或填错
• 认证信息：Gmail需开启SMTP认证，勾选「使用认证」后填写账号和应用专用密码（普通密码无效，需先开启两步验证）
• 端口与加密匹配：587端口对应勾选「使用STARTTLS」，465端口对应勾选「使用SSL」；25端口多数服务商已禁用，不建议使用

2. 手动触发邮件队列发送 #

APEX邮件默认定时（通常15分钟）推送队列，可手动执行PL/SQL强制发送，验证是否为队列未触发问题：

BEGIN
  APEX_MAIL.PUSH_QUEUE;
END;
/

若执行后收到邮件，说明定时任务未正常运行，需检查APEX定时作业配置。

3. 查询邮件日志获取错误详情 #

通过APEX内置日志表排查具体失败原因：

SELECT mail_id, to_address, subject, status, error_message
FROM apex_mail_log
ORDER BY created_on DESC;

error_message字段会明确显示问题，比如认证失败、SMTP连接超时、邮件被服务商拦截等，是定位问题的核心依据。

4. 验证数据库服务器网络连通性 #

确认数据库服务器能访问SMTP主机，用PL/SQL测试端口连通性：

DECLARE
  l_socket UTL_TCP.connection;
BEGIN
  l_socket := UTL_TCP.open_connection(
    remote_host => 'smtp.gmail.com', -- 替换为你的SMTP主机
    remote_port => 587
  );
  UTL_TCP.close_connection(l_socket);
  DBMS_OUTPUT.put_line('连接成功');
EXCEPTION
  WHEN OTHERS THEN
    DBMS_OUTPUT.put_line('连接失败: ' || SQLERRM);
END;
/

若连接失败，说明数据库服务器防火墙/安全组阻止了对应端口的出站请求，需开放587（或465）端口。

5. 修正邮件内容并规避拦截风险 #

• 补全HTML邮件中的重置链接，比如href='https://你的APEX域名/apex/f?p=100:5::NO::P5_RESET_TOKEN:xxx'（空链接不影响发送，但会降低邮件可信度）
• 避免使用垃圾邮件触发词，比如过多大写字母、可疑内容，防止被邮件服务商拦截

6. 确认执行权限 #

确保当前执行PL/SQL的用户拥有必要权限：

GRANT EXECUTE ON APEX_MAIL TO 你的用户名;
GRANT EXECUTE ON UTL_TCP TO 你的用户名;
GRANT EXECUTE ON UTL_SMTP TO 你的用户名;

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