oracle 12c+ 中 dbms_mail 已移除,必须改用 utl_mail 或 utl_smtp;utl_mail 需 dba 显式安装、授权、配置 smtp_out_server 参数并设置网络 acl,且仅支持明文 smtp,不支持 starttls。

Oracle 12c+ 中 DBMS_MAIL 已被彻底移除,调用直接报 ORA-00904: "dbms_mail": invalid identifier;必须用 UTL_MAIL(推荐)或 UTL_SMTP(需手写协议逻辑)。
UTL_MAIL 包是否已安装并启用?
它不是默认启用的组件,DBA 必须显式安装、配置参数、授权用户,缺一不可。
- 确认包存在且有效:
SELECT object_name FROM dba_objects WHERE object_name = 'UTL_MAIL' AND status = 'VALID'; - 安装脚本(需 SYS 执行):
@?/rdbms/admin/utlmail.sql和@?/rdbms/admin/prvtmail.plb(路径中?表示$ORACLE_HOME) - 授予执行权限(如给用户
APP_USER):GRANT EXECUTE ON UTL_MAIL TO APP_USER; - 检查网络 ACL 是否允许该用户调用网络包:
SELECT * FROM dba_network_acl_privileges WHERE principal = 'APP_USER' AND privilege = 'connect';,若无结果需由 DBA 运行DBMS_NETWORK_ACL_ADMIN相关过程添加
smtp_out_server 参数必须正确设置
UTL_MAIL 不读取代码里传的 SMTP 地址,只认数据库级参数 smtp_out_server。设错或为空,调用 UTL_MAIL.SEND 会静默失败或报 ORA-29279。
- 查看当前值:
SELECT value FROM v$parameter WHERE name = 'smtp_out_server';,返回空或NULL即未生效 - 设置命令(带端口,无协议前缀):
ALTER SYSTEM SET smtp_out_server = 'mail-relay.internal:25' SCOPE=BOTH; - 常见错误:写成
http://smtp.gmail.com:587(多出http://)、漏端口、用 IP 但 DNS 未解析、多个地址间用了空格而非逗号 - 注意:Oracle 12c+ 不再支持通过
db_domain自动推导,此参数必须显式设置
UTL_MAIL.SEND 调用时参数顺序与字符集不能错
参数顺序固定,且对中文、多收件人、特殊字符极其敏感。填错一个,可能无报错但邮件不达,或报误导性错误如 ORA-29260。
- 收件人多个时,用英文逗号分隔字符串:
'a@x.com,b@y.com'✅,'a@x.com, b@y.com'❌(末尾空格触发ORA-29260) - 中文主题/正文必须显式指定
mime_type => 'text/plain; charset=utf-8',否则按数据库字符集(如WE8ISO8859P1)发送,中文变问号 -
sender和recipients必须是完整邮箱格式,如'alert@company.com',不能是用户名或别名 -
subject中避免换行符(CHR(10))、制表符、全角引号;建议预处理:REPLACE(subject, CHR(10), ' ') - 正文超长(>32767 字节)会报
ORA-29260,不是长度参数错,是内容实际字节数超标
发不出邮件?先在数据库服务器上验证网络连通性
UTL_MAIL 完全依赖数据库服务器自身的 outbound 网络路径,和你的开发机、应用服务器网络无关。所有“没报错但没收到”的问题,80% 出在这里。
- 登录数据库服务器操作系统(Linux/Windows),执行:
telnet mail-relay.internal 25或openssl s_client -connect smtp.example.com:587 -crlf - 若超时或连接拒绝,说明防火墙、SELinux、代理、DNS 或企业安全策略已阻断 —— 此时
UTL_MAIL必然失败,不用查代码 - 企业环境常见限制:DB Server 禁外网,只允许走内部邮件中继(如
mail-relay.internal:25),必须用这个地址,不能直连 Gmail/QQ/163 - 注意:
UTL_MAIL只支持明文 SMTP,不支持 STARTTLS 或 SSL 封装。若目标端口(如 587)强制 STARTTLS,它会握手失败,应改用UTL_SMTP或换用支持明文的中继
最易被忽略的一点:即使所有配置都对,UTL_MAIL.SEND 在遇到 SMTP 层拒绝(如发信配额超限、收件人地址被拒、主题含敏感词)时,常返回模糊错误甚至静默丢弃,务必结合邮件服务器日志交叉验证,不能只看 PL/SQL 是否抛异常。











