本文详解如何在 oracle 存储过程中构建结构清晰、换行正确的 html 格式邮件正文，推荐使用 apex_mail 包替代底层 utl_smtp 手动拼接，避免纯文本换行混乱问题，并提供可直接复用的 html 构建示例与关键注意事项。
本文详解如何在 oracle 存储过程中构建结构清晰、换行正确的 html 格式邮件正文，推荐使用 apex_mail 包替代底层 utl_smtp 手动拼接，避免纯文本换行混乱问题，并提供可直接复用的 html 构建示例与关键注意事项。
在 Oracle 数据库中通过存储过程发送邮件时，若直接拼接纯文本作为邮件正文（如 p_body 参数），换行符（\n 或 chr(10)）常因邮件客户端解析差异而失效，导致内容挤成一行——正如您遇到的“Case id: … Case name: …”全部连排的问题。根本解法是主动构造语义明确的 HTML 正文，利用 <br>、<p> 或表格等标签控制布局，而非依赖纯文本换行。
✅ 推荐方案：使用 APEX_MAIL（无需额外安装，全版本通用）
APEX_MAIL 是 Oracle Application Express 提供的轻量级邮件 API，即使未部署 APEX 应用，也可在任意 Oracle 11gR2+ 数据库中启用并使用（需执行 @apex/utilities/apxmail.sql 初始化，或确认 APEX_XXXXXX 用户存在且权限就绪）。其最大优势在于支持 p_body_html 参数，直接传入标准 HTML 字符串，浏览器/邮件客户端能可靠渲染。
以下为改造示例——将原始混乱文本转为结构化 HTML：
DECLARE
l_html_body CLOB;
BEGIN
-- 动态构建 HTML 正文（使用标准 HTML 标签确保换行与语义）
l_html_body := q'[<!DOCTYPE html>
<html>
<head><meta charset="UTF-8"></head>
<body style="font-family: Arial, sans-serif; line-height: 1.6;">
<h3>Case Summary</h3>
<p><strong>Case id:</strong> 12345, 6789, 8989898</p>
<p><strong>Case name:</strong> name ; nameeeeeeeeeee</p>
<p><strong>Case Category:</strong><br>
• Email - post by post by post<br>
• Email - inbound/making fine and sending case<br>
• Email - Create date: today
</p>
</body>
</html>]';
-- 发送 HTML 邮件（自动处理 MIME 头、编码、队列）
APEX_MAIL.SEND(
p_to => 'recipient@example.com',
p_from => 'sender@example.com',
p_subj => 'Case Report - ' || TO_CHAR(SYSDATE, 'YYYY-MM-DD'),
p_body => 'Plain text fallback (optional)', -- 纯文本备选内容
p_body_html => l_html_body
);
-- 必须调用此过程提交邮件到队列（否则不会发送）
APEX_MAIL.PUSH_QUEUE;
EXCEPTION
WHEN OTHERS THEN
RAISE_APPLICATION_ERROR(-20001, 'Email send failed: ' || SQLERRM);
END;⚠️ 关键注意事项
- HTML 必须完整且合规：包含 <!DOCTYPE html>、<html>、<body> 结构，避免仅传 <p>xxx</p> 片段——部分邮件客户端（如 Outlook）会忽略不完整 HTML。
- 换行必须用 HTML 标签：<br> 用于单行换行，<p> 用于段落分隔；切勿依赖 chr(10) 或 \n 在 p_body_html 中生效。
- 字符编码显式声明：<meta charset="UTF-8"> 防止中文等特殊字符乱码。
- 样式内联优先：邮件客户端对 CSS 外链/<style> 标签支持极差，所有样式（如字体、行高）应写在 style 属性中。
- APEX_MAIL 需启用邮件服务：数据库需配置 SMTP_OUT_SERVER 参数（如 ALTER SYSTEM SET smtp_out_server='smtp.example.com:587' SCOPE=BOTH;），并确保网络可达。
- 替代方案（仅当无法用 APEX_MAIL）：若必须使用 UTL_SMTP，需手动构造 MIME 多部分消息，包含 Content-Type: text/html; charset=UTF-8 头及 Base64 编码——复杂度高、易出错，强烈不推荐。
通过 APEX_MAIL + 规范 HTML，您不仅能精准控制每行显示效果（如您的需求：Case id、Case name、Case Category 分行呈现），还能轻松扩展为带表格、颜色、链接的富文本报告，大幅提升自动化邮件的专业性与可读性。
立即学习“前端免费学习笔记（深入）”；
