Grails 5.3.6部署WebSphere遇Micronaut类缺失问题求助

问题分析 #

Grails 5.x底层基于Micronaut框架，io.micronaut.core.value.PropertyResolver是Micronaut核心类，部署到WebSphere时出现类找不到，通常是以下原因：

• Micronaut核心依赖未正确打包进WAR包
• WebSphere默认的父类加载器优先策略屏蔽了应用内的Micronaut类
• WebSphere自带依赖与应用依赖存在冲突

解决步骤 #

1. 确保Micronaut核心依赖被正确打包 #

检查build.gradle中的依赖配置，使用implementation依赖范围（避免使用provided/compileOnly），并指定Grails 5.3.6对应的Micronaut版本（3.9.x，可通过Grails官方文档确认具体版本）：

def micronautVersion = "3.9.4" // 替换为Grails 5.3.6匹配的版本

implementation "io.micronaut:micronaut-core:${micronautVersion}"
implementation "io.micronaut:micronaut-runtime:${micronautVersion}"
implementation "io.micronaut:micronaut-inject:${micronautVersion}"

执行grails clean war重新打包，解压WAR包检查WEB-INF/lib目录，确认包含micronaut-core-*.jar、micronaut-runtime-*.jar、micronaut-inject-*.jar文件。

2. 修改WebSphere类加载策略为PARENT_LAST #

WebSphere默认采用父类加载器优先，会优先加载容器自带的类，可能屏蔽应用内的Micronaut类：

• 登录WebSphere管理控制台，找到部署的应用
• 进入类加载和更新检测设置页面
• 将类加载顺序改为PARENT_LAST（应用类加载器优先）
• 保存配置并重启应用

3. 配置WebSphere应用类加载排除冲突依赖 #

创建或修改WEB-INF/ibm-web-ext.xml，明确设置类加载模式并排除可能冲突的容器依赖：

<web-ext xmlns="http://websphere.ibm.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd"
         version="1.0">
    <classloader mode="PARENT_LAST"/>
    <!-- 可选：排除WebSphere自带的冲突库，例如Spring相关模块 -->
    <library-refs>
        <library-ref name="SharedLib">
            <exclude-module name="spring-core"/>
        </library-ref>
    </library-refs>
</web-ext>

4. 强制WAR包包含所有运行时依赖 #

如果WAR包仍缺失依赖，调整build.gradle的war任务配置，确保所有运行时依赖被打包：

war {
    enabled = true
    from configurations.runtimeClasspath
}

5. 验证WebSphere JVM配置 #

确认WebSphere的JVM使用的是Java 8_261，且JVM参数未限制应用WEB-INF/lib目录的类加载，例如未通过-cp参数屏蔽应用库。

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