# 复杂结构 WS 接口注册问题
# 1. WebService 接口注册常见问题及处理
# 1.1 使用 WSDL 地址导入失败
现象：
页面报错“WSDL文件解析失败”，后台日志提示：Error occured when handle?wsdl reguest in ws inbound。
原因：
WSDL 文件中包含 <import> 或 <xsd> 标签，直接通过 URL 导入时无法正确解析依赖的资源文件。
解决方案：
不要使用“WSDL地址导入”方式。
改用 “WSDL文件导入” 方式，并将 WSDL 及其依赖的 import/XSD 文件按以下目录结构打包成 ZIP 上传：
wsdemo.zip └── wsdemo（文件夹） ├── wsdemo.wsdl └── import（文件夹,import中存放原接口的import、xsd文件）
示例附件：wsdemo.zip
# 1.2 访问 WSDL 文件需要登录验证
现象：
源 WebService 接口的 WSDL 访问需输入用户名/密码或证书认证。
解决方案：
- 不可使用“WSDL地址导入”方式，因为注册过程无法处理登录验证。
- 直接使用源业务服务的 WSDL 文件进行导入。
- 若 WSDL 文件中包含
<import>或<xsd>标签，请严格按照 1.1 节 的方法打包上传。
# 2. WebService 转 HTTP 代理注册
# 2.1 注册方式选择
若需要将 WebService 接口以 HTTP 协议暴露给消费方调用，请在注册时选择 “WS转HTTP” 方式。
# 2.2 报文转换配置
注册完成后，需在代理接口 > 报文转换处进行以下配置：
| 方向 | 转换类型 | 说明 |
|---|---|---|
| 请求报文 | JSON → XML | 将消费方传入的JSON转为SOAP/XML请求源业务接口 |
| 响应报文 | XML → JSON | 将源业务返回的XML响应转为JSON返回给消费方 |
# 2.3 JSON 报文结构要求
- 消费方发送的 JSON 请求报文必须与源业务接口的请求报文在参数及结构上完全一致。
- 只有保证结构一致，ESB Server 的转换逻辑才能正确地将 JSON 映射为业务系统预期的 XML 报文，避免转换失败或字段丢失。
📌 总结
处理复杂结构 WebService 接口注册的核心原则：
- 遇到 import/xsd 依赖或访问受控的 WSDL，一律采用离线文件打包导入。
- WS 转 HTTP 时，必须正确配置双向报文转换，并确保 JSON 结构与原接口请求报文匹配。