存储过程基于SQL查询结果动态触发邮件告警

先别急着往存储过程里塞调用——你多半会遇到那种“啥也不报错，邮件就是发不出去”的诡异情况。问题几乎全出在前置配置上，跟存储过程本身的代码逻辑关系不大。

下面这几个SQL Server数据库邮件配置的坑，是实战里最容易踩的，挨个检查一遍基本能解决八成邮件发送失败的问题。

必须手动启用数据库邮件、将msdb设为TRUSTWORTHY ON、把执行账号加入DatabaseMailUserRole，且@profile_name需显式指定、@recipients格式正确、@body防截断与乱码，失败须查阅sysmail_faileditems和sysmail_event_log系统表定位根因。

能发，但必须绕开“直接调用就静默失败”这个坑——绝大多数问题出在前置条件没配全，而不是sp_send_dbmail存储过程写得不对。

查这三件事：数据库邮件是否真启用、msdb是否TRUSTWORTHY ON、执行账号有没有DatabaseMailUserRole

sp_send_dbmail这个内置存储过程的行为很特别——它不报错也不提示，只把邮件丢进队列就返回0。但如果下面任何一个前提条件没满足，它根本不会把邮件排进队列：

• 没运行过 EXEC msdb.dbo.sysmail_start_sp —— 安装数据库邮件组件不等于服务自动启动，必须手动执行一次启动指令，很多人漏掉这一步导致邮件发不出。
• msdb 系统数据库没设为信任状态：ALTER DATABASE msdb SET TRUSTWORTHY ON，尤其当存储过程用了 EXECUTE AS USER 切换上下文时，权限链会断裂，邮件直接卡死在队列里。
• 当前执行账号（不是你登录SSMS的Windows账号，而是应用程序连接所用的SQL登录名）不在 msdb 的 DatabaseMailUserRole 角色中：USE msdb; EXEC sp_addrolemember 'DatabaseMailUserRole', 'your_app_login'。特别注意：sysadmin 固定服务器角色不会自动继承该数据库角色，必须显式添加才能发邮件。

@profile_name 必须显式指定，且环境间不能混用

不同环境的配置文件名称通常不一样（比如开发环境叫 DevMail，生产环境叫 ProdAlerts），一旦漏传参数或者硬编码错一个字母，sp_send_dbmail 就会静默失败不发送。这里有几个容易被忽视的细节：

• @profile_name 必须显式传入配置文件名，哪怕你只配了一个profile；依赖默认值会导致邮件发送失败。
• @recipients 只接受分号分隔的纯字符串收件人列表，结尾不能有多余分号（'a@b.com;b@c.com;' 这种格式会失败）。
• @body 邮件正文和 @subject 邮件主题避免嵌套单引号，改用 CONCAT() 或 FORMATMESSAGE() 安全构造，比如：CONCAT('库存低于阈值：', @stock)。
• 加上 @mailitem_id = @mail_id OUTPUT 捕获队列中的邮件项ID，后续可以查 sysmail_mailitems 系统表确认是否成功入队。

查询结果转 HTML 表格要防截断和乱码

直接拼接 @body 很容易触发 NVARCHAR(MAX) 截断、HTML 标签被邮件客户端解析、特殊字符（<、&）未转义导致内容丢失。下面这几个手法更稳定可靠：

• 用 FOR XML PATH('') + TYPE 模式构造HTML表格，比手拼字符串安全得多。
• 对字段值做HTML编码处理：REPLACE(REPLACE(REPLACE(@val, '&', '&'), '<', '<'), '>', '>')。
• 避免在 @body 中直接嵌入用户输入的长文本字段；优先用记录ID加前端链接的方式替代冗长文本展示。
• 如果用 @query 参数让 sp_send_dbmail 自动查询数据，注意它是在邮件实际发送时才执行查询，此时存储过程已退出，临时表或表变量不可见——这个坑很容易踩到。

发完没收到？别信 @@ERROR，查系统表才是真反馈

sp_send_dbmail 返回值永远是 0（表示成功入队），并不代表邮件真的发出去了。真正的失败发生在异步队列处理阶段，必须查系统表才能获得真实状态：

• 立刻查询 sysmail_faileditems 视图，看 last_mod_date 字段是否有最近 1 分钟内新增的失败记录。
• 结合 sysmail_event_log 查看具体错误描述，常见如：The mail could not be sent to the recipients because of the mail server failure（邮件服务器故障导致无法发送）。
• TRY...CATCH 和 @@ERROR 捕获不到队列层的异步错误，它们只管存储过程本身的执行状态。

真正容易被忽略的是：邮件配置正确 ≠ 邮件一定能发送成功，因为队列后台服务可能卡住、SMTP 服务器凭据过期、防火墙拦截出站 25 端口，这些都得靠查 sysmail_event_log 里的时间戳和错误描述才能精准定位。