sp_send_dbmail 调用失败主因是数据库邮件未启用、profile_name 未显式指定或拼写错误、html 邮件体中单引号/换行符未转义；需执行 sp_configure 启用功能，确认 profile 存在且名称一致，转义特殊字符，并查 sysmail_faileditems 和 windows 事件日志定位真实错误。
sp_send_dbmail 能用，但直接调就失败——它不依赖 SQL Server 自身发信能力，而是靠外部 SMTP 配置和后台邮件队列。没配好 profile_name、没启用数据库邮件、或收件人字段含非法字符，都会静默失败或进 sysmail_faileditems 表。
数据库邮件必须先启用，否则 sp_send_dbmail 直接报错
SQL Server 默认禁用数据库邮件功能，哪怕你已经配了 SMTP 账户，sp_send_dbmail 也会提示 “Database Mail is not enabled” 或干脆无响应。
- 执行这两条命令强制启用（需
sysadmin权限）：EXEC sp_configure 'show advanced options', 1;<br>RECONFIGURE;<br>EXEC sp_configure 'DATABASE MAIL XPS', 1;<br>RECONFIGURE;
- 启用后，
sysmail_event_log和sysmail_log才开始记录状态；查不到日志，大概率是这步漏了 - 重启 SQL Server 服务不会自动重载该配置，必须显式
RECONFIGURE
@profile_name 不是可选参数，多数场景下必须显式指定
文档写“默认值为 NULL”，但实际运行中：若当前用户没设默认专用配置文件，且 msdb 没设默认公共配置文件，sp_send_dbmail 就会报错 “No global profile is configured”。别赌运气。
- 用
SELECT * FROM msdb.dbo.sysmail_profile确认配置文件存在且名字拼写完全一致（区分大小写？不区分，但空格、全角符号会卡住） - 在
sp_send_dbmail调用里必须写死@profile_name = 'YourProfileName'，别依赖隐式查找 - 一个常见坑：配置向导里建的配置文件名带空格（如
'Alert Profile'），但代码里写了'AlertProfile'——查sysmail_profile表确认真实名称
动态拼接 HTML 邮件体时，单引号和换行符会直接导致 SQL 报错
用游标循环拼 @body 字符串时，如果字段值含单引号（如 O'Connor）或回车（CHAR(13)+CHAR(10)），会导致整个 EXEC 语句语法错误，邮件根本不会入队。
- 改用
QUOTENAME(..., '''')或REPLACE(@value, '''', '''''')转义单引号 - HTML 中换行不影响渲染，但 SQL 字符串里要避免裸
\n；统一用CHAR(13) + CHAR(10)或直接省略（浏览器自动折行） - 更稳的方式：把 HTML 构建逻辑移出 SQL，用 C# 或 PowerShell 组装好再传入参数，SQL 层只负责调用
- 示例安全拼接：
SET @v_body = '
'' + REPLACE(@v_br_id, '''', '''''') + '
发信失败不报错，得盯紧 sysmail_faileditems 和 Windows 事件日志
sp_send_dbmail 返回 0 只代表“已提交到队列”，不代表发送成功。失败常无声无息，直到你发现邮箱没收到、监控也没告警。
- 查失败原因优先看：
SELECT * FROM msdb.dbo.sysmail_faileditems ORDER BY last_mod_date DESC;
关键字段是description和last_mod_date - SMTP 连接超时、认证失败、发信配额超限，通常会在
description里写明（比如 “535 5.7.8 Error: authentication failed”） - Windows 事件查看器 → 应用程序日志 → 来源为
DatabaseMail的错误事件，比 SQL 表更早暴露底层网络问题 - 别只查
sysmail_sentitems，它只存“标记为已发送”的记录，不是真发出去了
真正卡住人的从来不是怎么写那行 EXEC msdb.dbo.sp_send_dbmail，而是 profile 名字少个空格、转义漏掉一个单引号、或者压根忘了 RECONFIGURE。这些地方一错，过程不报错，日志不亮灯，人就干坐那儿等收件箱刷新。
