WSO2 APIM 3.2.0通过Publisher更新API定义报MIME边界错误如何解决

完整报错日志如下：

TID: [-1234] [api/am/publisher] [2021-09-13 11:32:18,306] ERROR {org.wso2.carbon.apimgt.rest.api.util.exception.GlobalThrowableMapper} - An unknown exception has been captured by the global exception mapper. org.apache.cxf.interceptor.Fault: Couldn't find MIME boundary: ------WebKitFormBoundaryEsb6bxMwX39fG8Sb
at org.apache.cxf.interceptor.AttachmentInInterceptor.handleMessage(AttachmentInInterceptor.java:60)
at org.apache.cxf.jaxrs.ext.MessageContextImpl.createAttachments(MessageContextImpl.java:284)
at org.apache.cxf.jaxrs.ext.MessageContextImpl.get(MessageContextImpl.java:79)
at org.apache.cxf.jaxrs.impl.tl.ThreadLocalMessageContext.get(ThreadLocalMessageContext.java:42)
at org.apache.cxf.jaxrs.utils.multipart.AttachmentUtils.getMultipartBody(AttachmentUtils.java:143)
at org.apache.cxf.jaxrs.utils.multipart.AttachmentUtils.getAttachments(AttachmentUtils.java:155)
Caused by: java.io.IOException: Couldn't find MIME boundary: ------WebKitFormBoundaryEsb6bxMwX39fG8Sb
at org.apache.cxf.attachment.AttachmentDeserializer.initializeRootMessage(AttachmentDeserializer.java:140)
at org.apache.cxf.attachment.AttachmentDeserializer.initializeAttachments(AttachmentDeserializer.java:110)
at org.apache.cxf.interceptor.AttachmentInInterceptor.handleMessage(AttachmentInInterceptor.java:58)
... 54 more

该错误本质是服务端Apache CXF组件解析前端提交的multipart/form-data类型请求时，找不到请求头中约定的MIME边界字符串，导致请求解析失败，可按以下步骤依次排查修复：

1. 前端环境排查 #

• 禁用浏览器所有广告拦截、请求篡改类插件，此类插件常会截断或修改multipart请求的body内容，导致边界丢失。禁用后重启浏览器重试更新操作。
• 更换Chrome/Edge官方最新版本浏览器重试，部分小众浏览器或老旧版本浏览器对multipart表单的构造存在兼容性缺陷，会导致边界定义和实际body内容不匹配。

2. API定义文件排查 #

• 确认上传的Swagger/OpenAPI定义文件无语法错误，文件大小未超过WSO2默认的10MB上传限制。如果文件过大，可修改配置调整上传阈值：
  打开<APIM_HOME>/repository/conf/deployment.toml文件，添加或修改如下配置：

  [apim.openapi]
  max_file_size = 20971520 # 单位为字节，此处设置为20MB，可按需调整
  

  修改完成后重启APIM服务生效。

3. 修复版本内置解析缺陷 #

WSO2 APIM 3.2.0版本默认的CXF拦截器对部分特殊格式的multipart请求解析存在兼容性问题，可通过配置禁用多余的附件拦截器解决：
打开<APIM_HOME>/repository/conf/deployment.toml，添加如下配置：

[cxf]
disable_multipart_attachment_interceptor = true

保存后重启APIM服务，再重试更新API定义操作。

4. 代理层配置排查 #

• 如果APIM Publisher前端部署了Nginx、Apache等反向代理或WAF设备，需确认代理层未修改请求的Content-Type头，也未截断请求body，尤其要确认Content-Type: multipart/form-data; boundary=xxx头在转发过程中被完整保留，boundary值和请求body内的边界值完全一致。
• 部分WAF会默认过滤包含WebKitFormBoundary的请求内容，需将Publisher门户的相关请求路径加入WAF白名单。

内容的提问来源于stack exchange，提问作者Ram Kishan Maitry