部署启用oauth2-custom-policy的Mule API遇xsd解析错误求助

我们已将兼容Java17的oauth2-custom-policy部署至Exchange，并在API Manager中完成配置。但在API Manager部署使用该自定义策略的API时，出现如下错误：

Error loading: /opt/mule/mule-4.6-java17/policies/oauth2-custom-policy-6242769/policy.xml, Can't resolve http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd, A dependency or plugin might be missing.

关键配置信息：

• 自定义策略POM.xml中已添加依赖：

  com.mulesoft.anypoint:mule-http-policy-transform-extension:${http.policy.transform.extension}:mule-plugin
  org.mule.connectors:mule-http-connector
  

• 配置属性：

  <http.policy.transform.extension>3.2.0</http.policy.transform.extension>
  <mule.maven.plugin.version>4.2.0</mule.maven.plugin.version>
  

• 单独部署该Mule API（不启用oauth2-custom-policy）可成功运行。

解决步骤 #

1. 完善HTTP连接器依赖配置 #

mule-http-connector依赖需要明确指定版本和mule-plugin分类器，自定义策略依赖插件形式的连接器才能正确引入schema文件。修改POM.xml中的依赖：

<dependency>
    <groupId>org.mule.connectors</groupId>
    <artifactId>mule-http-connector</artifactId>
    <version>1.15.0</version> <!-- 适配Mule 4.6的推荐版本，可根据官方兼容矩阵调整 -->
    <classifier>mule-plugin</classifier>
</dependency>

2. 调整Mule Maven Plugin打包配置 #

在POM的build节点下，确保mule-maven-plugin配置正确包含依赖的Mule插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.mule.tools.maven</groupId>
            <artifactId>mule-maven-plugin</artifactId>
            <version>${mule.maven.plugin.version}</version>
            <extensions>true</extensions>
            <configuration>
                <classifier>mule-plugin</classifier>
                <includeMuleDependencies>true</includeMuleDependencies>
            </configuration>
        </plugin>
    </plugins>
</build>

includeMuleDependencies设为true会强制将所有依赖的Mule插件打包到策略JAR中，确保部署时能找到对应的schema定义。

3. 验证策略包内容 #

重新构建策略后，解压生成的JAR文件，检查META-INF/mule/schemas目录下是否存在mule-http.xsd文件。如果缺失，说明依赖未被正确打包，需重新检查Maven配置。

4. 确认Runtime环境插件完整性 #

如果策略包已包含正确依赖，仍出现错误，需确认API Manager使用的Mule 4.6-Java17 Runtime环境中已安装mule-http-connector插件，避免环境级别的依赖缺失。

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