先别急着往存储过程里塞
下面这几个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 里的时间戳和错误描述才能精准定位。
