SQL Server Database Mail配置不生效的典型表现是sp_send_dbmail返回成功但收件人未收到邮件，或报错“mail server failure”；根本原因多为SQL Server Agent未运行、SMTP服务器配置错误、邮件配置文件未授权、@body_format未显式指定及动态拼接未转义等。
SQL Server里Database Mail配置不生效的典型表现
发邮件时sp_send_dbmail返回成功，但收件人没收到；或直接报错The mail could not be sent to the recipients because of the mail server failure。这通常不是代码问题，而是底层配置没走通。
关键检查点：
- SQL Server Agent服务是否运行（Database Mail依赖它异步投递）
-
sysmail_servertype视图中显示的服务器类型是否为SMTP，端口是否与邮件服务商要求一致（如Outlook用587，部分企业邮箱用465） - 数据库邮件配置文件（Profile）是否已授予给目标用户或角色：
EXEC msdb.dbo.sysmail_add_principalprofile_sp @principal_name='public', @profile_name='MyProfile', @is_default=1
存储过程中调用sp_send_dbmail必须处理的参数陷阱
很多人直接拼接@body参数传入HTML字符串，结果邮件内容乱码或样式丢失——根本原因是@body_format没显式指定'HTML'，默认是'TEXT'，导致浏览器把<b></b>当纯文本渲染。
常用参数组合建议：
-
@recipients：多个邮箱用分号;分隔，不能用逗号，否则只认第一个 -
@body_format = 'HTML'必须显式写，哪怕你只发纯文本，也建议设成'TEXT'而非省略 -
@execute_query_database若要查其他库，必须写全名，如'SalesDB'，不能用USE SalesDB前缀 -
@query_result_header = 0可关闭列名头，避免邮件里多出一行无用字段名
示例片段：
EXEC msdb.dbo.sp_send_dbmail
@profile_name = 'AlertProfile',
@recipients = 'admin@company.com',
@subject = '订单超时预警',
@body = '<p>以下订单已超时：</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/code/11413" title="AI舌诊面诊问诊医疗系统+诊疗商城系统源码"><img
src="https://img.php.cn/upload/webcode/000/000/000/6a5591f290d1f849.png" alt="AI舌诊面诊问诊医疗系统+诊疗商城系统源码" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/code/11413" title="AI舌诊面诊问诊医疗系统+诊疗商城系统源码">AI舌诊面诊问诊医疗系统+诊疗商城系统源码</a>
<p>AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。</p>
</div>
<a href="/xiazai/code/11413" title="AI舌诊面诊问诊医疗系统+诊疗商城系统源码" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><table>...</table>',
@body_format = 'HTML',
@importance = 'High';在存储过程里安全拼接动态邮件内容的避坑方式
别用+' '+直接拼@body，尤其当字段含单引号或换行符时，会破坏SQL语法或HTML结构。应统一用REPLACE()和QUOTENAME()预处理。
更稳妥的做法是用FOR XML生成HTML表格：
- 对查询结果用
FOR XML RAW('tr'), ELEMENTS, TYPE转成XML，再用.value()提取并包裹<td> <li>用<code>ISNULL(@var, '')代替@var直用，防止NULL让整个@body变NULL - 若需嵌入变量值到HTML属性（如
href="xxx?id='+CAST(@id AS VARCHAR)+'"），先用REPLACE(@val, '"', '"')转义双引号 - 查发送历史：
SELECT * FROM msdb.dbo.sysmail_allitems WHERE send_request_date > GETDATE()-1 - 查失败详情：
SELECT * FROM msdb.dbo.sysmail_event_log WHERE event_type = 'error' - 查附件大小限制：
SELECT * FROM msdb.dbo.sysmail_configuration WHERE parameter_name = 'MaxFileSize'（默认1000000字节≈1MB）
简单替代方案：用STRING_AGG()（SQL Server 2017+）拼接行，比游标快且不易出错。
Database Mail日志和失败排查的实用路径
所有发送记录和错误细节都存在msdb库的三张表里，不是Windows事件日志——很多人找错地方。
注意：sysmail_faileditems只存失败项，但不会自动重试；如果发现大量状态为unsent，大概率是SQL Server Agent停了，或网络策略拦截了出站SMTP连接。
真正卡住的地方往往不在T-SQL语法，而在SMTP认证方式（比如是否启用了OAuth2）、防火墙规则、或邮件服务商对发信频率的限制——这些得去网络和邮件服务后台查，不是改几行代码能解决的。
