绝大多数“存储过程发不了邮件”问题源于前置条件未满足：数据库邮件未启用、msdb未设TRUSTWORTHY ON、执行账号不在DatabaseMailUserRole角色中；调用sp_send_dbmail必须显式指定@profile_name，且需查sysmail_faileditems和sysmail_event_log确认真实失败原因。
绝大多数“存储过程发不了邮件”的问题，根本不在 sp_send_dbmail 调用逻辑里，而是前置条件没满足——它不报错、不抛异常，只静默失败。
查这三件事：数据库邮件是否真启用、msdb 是否 TRUSTWORTHY ON、执行账号有没有 DatabaseMailUserRole
开发环境能发、生产环境静默失败？先别改存储过程，直接连上目标 SQL Server 实例，依次确认：
-
sysmail_start_sp是否已执行过？装完数据库邮件不等于自动启动，必须手动运行一次：EXEC msdb.dbo.sysmail_start_sp;
-
msdb数据库是否设为信任？尤其在存储过程中用了EXECUTE AS USER时，权限链会断：ALTER DATABASE msdb SET TRUSTWORTHY ON;
- 当前执行账号（不是你 SSMS 登录的 Windows 账号，而是作业或应用连接用的 SQL 登录名）是否在
DatabaseMailUserRole角色中？USE msdb; EXEC sp_addrolemember 'DatabaseMailUserRole', 'your_app_login';
注意：sysadmin不自动继承该角色权限。
调用 sp_send_dbmail 时必须显式指定 @profile_name，且不能依赖默认值
不同环境 profile 名通常不同（如开发叫 DevMail，生产叫 ProdAlerts），硬编码或漏写会导致入队失败但无提示：
-
@profile_name必须显式传入，哪怕只配了一个 profile； -
@recipients用分号分隔多个邮箱，但结尾不能有多余分号（'a@b.com;b@c.com;'会失败）； -
@body和@subject避免拼接单引号嵌套，改用变量 +CONCAT()或FORMATMESSAGE()构造； - 加
@mailitem_id = @mail_id OUTPUT捕获队列 ID，后续可查sysmail_mailitems确认是否成功入队。
示例（安全写法）：
DECLARE @body NVARCHAR(MAX) = CONCAT('告警时间：', GETDATE(), '，影响行数：', @affected_rows);
DECLARE @mail_id INT;
EXEC msdb.dbo.sp_send_dbmail
@profile_name = 'ProdAlerts',
@recipients = 'alert@company.com',
@subject = '【PROD】订单处理失败',
@body = @body,
@mailitem_id = @mail_id OUTPUT;
发完邮件没收到？别信 @@ERROR 或 TRY...CATCH，查系统表才是真反馈
sp_send_dbmail 返回值永远是 0（仅表示请求已入 Service Broker 队列），真正失败发生在异步外部进程处理阶段，SQL 层完全捕获不到：
- 立刻查
msdb.dbo.sysmail_faileditems，看last_mod_date是否在最近 1 分钟内有新增记录； - 结合
msdb.dbo.sysmail_event_log查具体错误，常见如：The mail could not be sent to the recipients because of the mail server failure； -
sysmail_allitems和sysmail_sentitems可确认是否真的发出（sent_status = 1）； - 不要在存储过程中仅靠
IF @@ERROR <> 0判断发送成败——它永远为 0。
为什么测试能发、上线就失效？注意上下文切换和执行账号差异
SSMS 里右键执行能通，但 SQL Server Agent 作业或应用程序调用就失败，大概率栽在这两个点：
- 未显式指定
msdb.dbo.sp_send_dbmail，而存储过程所在数据库做了USE your_db，导致解析失败； - SSMS 用 Windows 身份登录，作业用 SQL 登录账号（如
sql_job_user），后者很可能没被加进DatabaseMailUserRole，也没被赋予TRUSTWORTHY ON权限； - 生产环境 SMTP 服务器可能限制 IP 白名单或需额外认证（比如 QQ 邮箱要求授权码而非密码），而开发环境直连公网 SMTP 无此限制。
最易被忽略的点：所有检查都通过后，仍要确认 sysmail_mailitems 表里 sent_status 字段的更新延迟——它不是实时写入的，查表前等 5–10 秒再查更可靠。
