Tomcat8.5.57下Cortona 3D Solo 2.0的WASM编译错误解决求助

问题根源 #

Tomcat 8.5.57会自动给application/wasm类型的响应附加;charset=utf-8后缀，而Firefox对WASM的MIME类型校验严格，不允许携带charset参数，导致出现wasm streaming compile failed错误——即使你已经在web.xml中添加了正确的mime-mapping，Tomcat的自动charset附加逻辑仍会覆盖配置。

解决步骤 #

1. 添加响应头过滤器强制修正Content-Type
   在Tomcat全局的conf/web.xml中插入以下过滤器配置，专门拦截.wasm文件的响应，强制设置纯application/wasm类型：

   <filter>
       <filter-name>WasmContentTypeFix</filter-name>
       <filter-class>org.apache.catalina.filters.ResponseHeaderFilter</filter-class>
       <init-param>
           <param-name>Content-Type</param-name>
           <param-value>application/wasm</param-value>
       </init-param>
   </filter>
   <filter-mapping>
       <filter-name>WasmContentTypeFix</filter-name>
       <url-pattern>*.wasm</url-pattern>
   </filter-mapping>
   

2. 确认已有MIME映射配置
   确保Tomcat全局conf/web.xml和应用自身的web.xml中都已包含正确的MIME映射（你已完成此步骤，可再次核对）：

   <mime-mapping>
       <extension>wasm</extension>
       <mime-type>application/wasm</mime-type>
   </mime-mapping>
   

3. 重启Tomcat
   重新启动Tomcat服务器，让新的过滤器配置生效。

4. 验证修复效果
   打开Firefox的开发者工具（F12），切换到「网络」标签，加载页面后找到.wasm文件的请求，查看响应头中的Content-Type字段，确认其值为application/wasm，无任何charset后缀。

补充说明 #

• 该问题仅在Firefox出现，是因为Chrome等浏览器对WASM的MIME类型校验相对宽松，允许携带charset参数；而Firefox严格遵循WebAssembly规范，必须使用纯application/wasm类型。
• 此方案无需升级Tomcat版本，完全适配8.5.57版本。

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