解决Salesforce无法向外发送邮件

问题

有时,我们想在Salesforce组织(Org)中自动对外发送邮件。例如,我们可以使用下面的Apex代码实现。

首先,创建一个方便我们快速发送邮件至单个收件人地址的类。

java 复制代码
// 创建一个方便复用,负责发送单个邮件的功能类
public class EmailManager {
	
	// 主要的发送邮件方法
    public void sendMail(String address, String subject, String body) {
        // 创建一个新邮件消息对象
        Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage();

        // 设置邮件消息的收件地址、主题和正文内容
        mail.setToAddresses(new String[] { address }); // 尽管目标地址只有一个,但因Salesforce默认设计为方便批量发送,必须以列表(数组)形式传参
        mail.setSubject(subject);
        mail.setPlainTextBody(body);
        // 因默认方便批量发送,`发送结果`对象也必须用列表(数组)捕捉
        Messaging.SendEmailResult[] results = Messaging.sendEmail(
            new Messaging.SingleEmailMessage[] {mail}
        );
        inspectResults(results);
    }

    // 一个仅供内部使用的私有方法,用于快速检查邮件是否全部发送成功
    private static Boolean inspectResults(Messaging.SendEmailResult[] results) {
        // 默认所有邮件都发送成功
        Boolean sendResult = true;
        
        for (Messaging.SendEmailResult res : results) {
            // 对于每个发送结果,检查是否成功
            if (res.isSuccess()) {
                System.debug('Email sent successfully');
            }
            else {
                // 如果失败,将`所有邮件都发送成功`设置为否,并在运行日志中提示
                sendResult = false;
                System.debug('The following errors occurred: ' + res.getErrors());
            }
        }
        
        return sendResult;
    }
}

之后,调用我们自己编写的类------创建一个对象,并用其发送邮件。

java 复制代码
EmailManager em = new EmailManager();
em.sendMail(
    'someone@gmail.com',
    'Test Email',
    'This is a test body'
);

现象

然而,过了很久,我们的Gmail邮箱中都并无邮件显示,哪怕是垃圾邮件分类中。

故障排查

检查日志

这一现象非常反常。我们首先应检查日志,检查是否发送成功。

log 复制代码
66.0 APEX_CODE,FINEST;APEX_PROFILING,INFO;CALLOUT,INFO;DATA_ACCESS,INFO;DB,INFO;NBA,INFO;SYSTEM,DEBUG;VALIDATION,INFO;VISUALFORCE,INFO;WAVE,INFO;WORKFLOW,INFO
Execute Anonymous: EmailManager em = new EmailManager();
Execute Anonymous: em.sendMail(
Execute Anonymous:     'someone@gmail.com',
Execute Anonymous:     'Test Emaill',
Execute Anonymous:     'This is a test body'
Execute Anonymous: );
19:08:22.1 (1715616)|USER_INFO|[EXTERNAL]|...

然而,我们程序打印消息,声称发送成功。

log 复制代码
...
19:08:22.1 (85500107)|USER_DEBUG|[18]|DEBUG|Email sent successfully
...

而且,日志也显示邮件被成功加入邮件发送队列。

log 复制代码
19:08:22.1 (83919155)|EMAIL_QUEUE|[8]|subject: Test Email, bccSender: false, saveAsActivity: true, useSignature: true, toAddresses: [someone@gmail.com], plainTextBody: This is a test body, 
...

这十分诡异。让我们检查一下组织(Org)设置。

检查可交付性设置

每个组织中都有一处可以设置可交付性(Deliverability)------控制是否允许邮件发出。

然而,当前设置已经允许向任何邮件发送出站(outbound)邮件。

这十分反常。为了进一步测试,我们直接用系统的测试功能向邮箱发送测试邮件。

然而我们却未曾收到任何内容。

检查邮箱端

也许这是Gmail的问题?让我们更换到Hotmail (Outlook) 试试。将目标邮箱更改为一Outlook邮箱,再次发送测试邮件。

我们立刻收到了邮件,尽管位于垃圾邮件中。

既然如此,让我们重新运行匿名Apex代码,发送调用之前编写的类邮件。

java 复制代码
EmailManager em = new EmailManager();
em.sendMail(
    'someone@hotmail.com',
    'Test Email',
    'This is a test body'
);

我们立刻收到了Apex代码发送的邮件。问题解决。

结论

有时,Gmail的垃圾邮件屏蔽策略过于激进,反而导致了不必要的问题。问题可能出在接收端,而非发送端(Apex)。

相关推荐
feixing_fx6 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
Evand J7 小时前
【MATLAB例程】二维IMM-UKF定位,基于四个基站的AOA与测距辅助
开发语言·matlab
feixing_fx7 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
个 人 练 习 生8 小时前
C++:从零基础到深入了解vector的使用
开发语言·c++·经验分享·学习·程序人生·stl
好的佩奇8 小时前
蓝牙之设备角色与连接
android·flutter·蓝牙
兴趣互联8 小时前
jeecgboot nacos2.3.2 使用pgsql
java
H.莓飛8 小时前
【C++】【STL】stack_OJ题
服务器·c语言·开发语言·数据结构·c++·算法·visual studio
hudd6689 小时前
JavaEE 初阶 - 文件操作和IO
java·开发语言·java-ee
Rabitebla9 小时前
【Linux操作系统】 文件篇(一):文件描述符与 Linux 文件管理机制
linux·网络·c++·笔记·学习
Flynn Liang9 小时前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化