必须手动启用数据库邮件、设置msdb为TRUSTWORTHY ON、将执行账号加入DatabaseMailUserRole,且@profile_name需显式指定、@recipients格式正确、@body防截断与乱码,失败须查sysmail_faileditems和sysmail_event_log。
能发,但必须绕开“直接调用就静默失败”这个坑——绝大多数问题出在前置条件没配全,而不是存储过程写得不对。
sp_send_dbmail不报错也不提示,只把邮件丢进队列就返回 0,但若以下任一条件不满足,它就根本不会入队:
EXEC msdb.dbo.sysmail_start_sp —— 装完数据库邮件不等于自动启动,必须手动执行一次msdb 数据库没设为信任:ALTER DATABASE msdb SET TRUSTWORTHY ON,尤其当存储过程用了 EXECUTE AS USER 时,权限链会断msdb 的 DatabaseMailUserRole 角色里:USE msdb; EXEC sp_addrolemember 'DatabaseMailUserRole', 'your_app_login';注意:sysadmin 不自动继承该角色不同环境 profile 名通常不同(如开发叫 DevMail,生产叫 ProdAlerts),漏传或硬编码错一个字母,sp_send_dbmail 就静默失败:
@profile_name 必须显式传入,哪怕只配了一个 profile;依赖默认值会失败@recipients 只接受分号分隔的纯字符串,结尾不能有多余分号('[email protected];[email protected];' 会失败)@body 和 @subject 避免嵌套单引号,改用 CONCAT() 或 FORMATMESSAGE() 构造,例如:CONCAT('库存低于阈值:', @stock)
@mailitem_id = @mail_id OUTPUT 捕获队列 ID,后续可查 sysmail_mailitems 确认是否成功入队直接拼接 @body 容易触发 NVARCHAR(MAX) 截断、HTML 标签被解析、特殊字符(<、&)未转义导致内容丢失:
FOR XML PATH('') + TYPE 构造表格,比手拼更安全可靠REPLACE(REPLACE(REPLACE(@val, '&', '&'), '', '>')
@body 中直接嵌入用户输入字段;优先用 ID + 前端链接替代长文本展示@query 参数让 sp_send_dbmail 自动查数据,注意它是在邮件发送时才执行,此时存储过程已退出,临时表或变量不可见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 凭据过期、防火墙拦截 outbound port 25,这些都得靠查 sysmail_event_log 里的 timestamp 和 error_description 才能定位。