集成WSO2 API Manager时，API网关返回后端XLSX文件二进制响应问题

问题根源 #

WSO2网关默认会把响应按JSON/XML这类文本格式处理，碰到后端返回的XLSX二进制文件时，没识别出这是需要触发下载的文件类型，直接把二进制数据流输出了，导致浏览器显示乱码或者没法自动下载文件。

具体解决步骤 #

• 给API配置正确的响应介质类型
  登录API Publisher，找到目标API进入设计页面，定位到返回XLSX的那个资源，在响应设置里添加 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet 作为允许的响应介质类型，让网关能认出这是XLSX文件。

• 关掉不必要的响应内容转换
  进到API的「Runtime Configurations」>「Message Mediation」，把默认会把响应转成JSON/XML的中介逻辑删掉或者禁用。如果需要保留其他类型的转换，就加个判断跳过XLSX的转换：

  <filter source="$ctx:MESSAGE_TYPE" regex="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet">
      <then>
          <log level="custom">
              <property name="INFO" value="检测到XLSX文件，跳过内容转换"/>
          </log>
          <send/>
      </then>
      <else>
          <!-- 这里留着你原来处理其他响应类型的逻辑 -->
      </else>
  </filter>
  

• 确保下载响应头能正常传递
  后端返回的 Content-Disposition 头（比如 attachment; filename="报表.xlsx"）是触发浏览器下载的关键，要保证网关不会把这个头过滤掉。可以在API的「Out Headers」配置里添加规则，强制传递这个响应头。

• 检查网关的二进制响应配置
  打开WSO2 APIM的 repository/conf/deployment.toml 文件，确认有没有下面这个配置，没有的话加上，然后重启网关：

  [apim.gateway]
  enable_binary_response = true
  

验证方法 #

改完配置重新发布API，调用接口时看响应头里有没有正确的 Content-Type（对应XLSX的MIME类型）和 Content-Disposition，确认浏览器能自动弹出下载框，而不是显示一堆乱码。

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