WSO2 ESB使用Email Connector报错，部署CAR应用遇类缺失问题

1. 序列模板找不到 org.wso2.carbon.connector.email.send 的问题根源 #

这个错误说明运行时无法定位Email Connector的send操作模板，核心原因是连接器未被正确打包到CAR应用中，或是Connector Exporter配置错误导致依赖缺失。

2. Connector Exporter 参数取值说明 #

创建Connector Exporter模块时，参数按以下规则填写：

• Group ID：与你的主ESB项目Group ID保持一致（例如com.yourcompany.esb），用于标识项目组归属
• Parent Group ID：固定填写org.wso2.carbon.connectors，这是WSO2官方所有连接器的父项目Group ID
• Parent Artifact ID：固定填写carbon-connectors-parent，这是WSO2官方连接器的父构件统一ID
• Version：与你添加的Email Connector版本完全匹配（例如ESB 6.6.0推荐搭配4.0.15版本）

同时需确保Connector Exporter的pom.xml中正确引入Email Connector依赖：

<dependencies>
    <dependency>
        <groupId>org.wso2.carbon.connectors</groupId>
        <artifactId>email-connector</artifactId>
        <version>4.0.15</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

3. 解决CAR部署时的 NoClassDefFoundError 与 SynapseArtifactDeploymentException #

这两个错误通常源于CAR包未包含连接器完整依赖，或是版本不兼容：

• 版本兼容性校验：确认Email Connector版本与ESB版本匹配（如ESB 7.0.0需搭配更高版本的Email Connector），版本不匹配会直接导致类加载失败
• 正确打包CAR应用：在Integration Studio中，右键Composite Application项目 → Export Composite Application Project，务必勾选Connector Exporter模块，将其纳入CAR包
• 依赖范围配置：Connector Exporter的依赖scope设为compile，确保依赖被打包进CAR；若ESB服务器已全局安装Email Connector，可设为provided，但推荐打包进CAR以保证环境一致性

4. API配置校验 #

确保你的API/序列中调用Email Connector的语法正确，且已配置对应的Email端点：

<!-- 示例Email发送序列配置 -->
<sequence name="SendEmailSeq" xmlns="http://ws.apache.org/ns/synapse">
    <email.send configKey="EmailSMTPConfig">
        <from>your-sender@domain.com</from>
        <to>recipient@domain.com</to>
        <subject>ESB Test Email</subject>
        <body>Email content from WSO2 ESB</body>
    </email.send>
</sequence>

<!-- 对应的Email端点配置 -->
<endpoint name="EmailSMTPConfig" xmlns="http://ws.apache.org/ns/synapse">
    <property name="mail.smtp.host" value="smtp.domain.com"/>
    <property name="mail.smtp.port" value="587"/>
    <property name="mail.smtp.auth" value="true"/>
    <property name="mail.smtp.starttls.enable" value="true"/>
    <property name="mail.username" value="your-sender@domain.com"/>
    <property name="mail.password" value="your-password"/>
</endpoint>

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