JBoss7.0迁移到Tomcat8.5后Java跨应用调用报类型转换错误

• 报错核心原因是代码中的强制类型转换不符合Servlet规范：Servlet API中HttpServletRequest.getParameterMap()的返回值定义为Map<String, String[]>接口，官方从来没有承诺过返回HashMap实现类
• JBoss 7.0的内部实现刚好返回的是HashMap子类，所以之前运行没有问题；Tomcat 8.5中该方法返回的是自定义实现类org.apache.catalina.util.ParameterMap，该类仅实现了Map接口，和HashMap没有继承关系，强转直接抛出类型转换异常
• Portal单独运行正常是因为Portal代码中没有类似的强转逻辑，只有Report应用的这段代码存在不规范写法，所以仅调用Report时报错

方案1（最优，推荐）：调整代码面向接口编程 #

修改ReportVO类的attributes属性类型，以及对应setAttributes方法的入参类型为Map<String, String[]>，不需要强制转换，直接写：

ReportVO reportVO = new ReportVO();
reportVO.setAttributes(request.getParameterMap());

这种写法完全符合Servlet规范，后续更换任何兼容Servlet标准的容器都不会出现同类问题。
注意：Tomcat返回的ParameterMap是只读实现，如果后续业务需要修改attributes中的键值，不要用方案1，选择方案2生成可修改的HashMap实例

方案2（兼容场景，VO无法修改时使用）：手动转换为HashMap #

如果ReportVO是第三方依赖不能修改、必须传入HashMap类型，就手动把参数复制到新的HashMap实例中：

ReportVO reportVO = new ReportVO();
reportVO.setAttributes(new HashMap<>(request.getParameterMap()));

没有任何Tomcat服务端配置可以解决这个问题，该问题是代码不规范导致的兼容性问题，和服务端配置无关。

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