Guidewire邮件插件配置及EmailUtil发送邮件失败排查求助

一、先确认基础SMTP服务器配置（gwconfig.properties） #

所有邮件发送的核心依赖是这个配置文件，必须正确设置以下参数：

• smtp.host=你的SMTP服务器地址（比如smtp.gmail.com）
• smtp.port=587（根据服务商选择，25/465/587都可能）
• smtp.auth=true（如果服务器需要认证）
• smtp.username=你的发件邮箱账号
• smtp.password=你的邮箱密码/授权码（注意：第三方邮箱比如Gmail需要用应用授权码）
• smtp.starttls.enable=true（如果用TLS加密，587端口一般需要）
• 若服务器证书未被信任，添加smtp.ssl.trust=你的SMTP服务器地址避免证书验证失败

二、邮件插件的启用与配置 #

1. 确保EmailPlugin已加载：在plugins.xml中添加或确认以下配置：

<plugin name="EmailPlugin" class="com.guidewire.pl.email.EmailPlugin"/>

2. 配置默认发件人（可选但推荐）：在pluginconfig/EmailPlugin.properties中设置：

default.from=your-default-sender@yourdomain.com

如果不配置这个，调用sendEmailWithBody时必须显式传入fromEmail参数。

三、EmailUtil.sendEmailWithBody的正确调用示例 #

很多无响应问题源于参数错误，以下是标准调用代码：

import com.guidewire.pl.email.EmailUtil

// 必须是非空的收件人列表
def toRecipients = ["user1@example.com", "user2@example.com"]
def ccRecipients = [] // 可选，空列表没问题
def bccRecipients = [] // 可选
def subject = "测试邮件"
def body = "这是来自Guidewire的测试邮件内容"
def fromEmail = "sender@example.com" // 若未配置默认发件人，此参数必填

// 执行发送
EmailUtil.sendEmailWithBody(toRecipients, ccRecipients, bccRecipients, subject, body, fromEmail)

注意：

• 收件人列表不能为null或空列表，否则方法会静默跳过发送
• 不要传入格式错误的邮箱地址，比如带空格或缺少@符号的地址

四、无异常但不发邮件的排查步骤 #

1. 查看日志：优先检查logs/email.log，如果没有就看主日志gw.log，搜索EmailUtil、sendEmail或SMTP相关关键字，会找到静默失败的原因（比如连接超时、服务器拒绝、收件人无效）
2. 测试网络连通性：在Guidewire服务器上用命令测试SMTP服务器是否可达：

telnet your-smtp-server 587

如果连接失败，说明是防火墙或网络路由问题，需要运维配合排查
3. 检查邮件拦截：邮件可能被SMTP服务器当成垃圾邮件拦截，去发件人的已发送/垃圾邮件文件夹查看，或者联系邮件服务商确认规则
4. 确认调用上下文：如果是在后台任务或自定义服务中调用，确保代码所在类有足够的权限，比如添加@RequiresPermission("EmailSend")注解（根据你的权限配置调整）

五、最容易遗漏的细节 #

• 修改配置后必须重启Guidewire服务，否则配置不会生效
• 密码包含特殊字符时，需要在gwconfig.properties中转义，比如用双引号包裹：smtp.password="your#pass@word"
• 若使用465端口（SSL加密），需要替换smtp.starttls.enable=true为smtp.ssl.enable=true

内容的提问来源于stack exchange，提问作者Gagan Jain