如何解决Gradle与Open Liberty 24的installFeature任务报错问题

错误信息 #

任务:installFeature执行失败，抛出异常：

net.wasdev.wlp.common.plugins.util.PluginExecutionException: com.ibm.ws.install.InstallException: CWWKF1203E: 无法找到以下特性：microProfile-6.1。请确保特性名称正确。

环境信息 #

• Gradle版本：6.6.1
• Liberty Gradle插件版本：3.0
• Open Liberty版本：24.0.0.1

build.gradle相关代码片段 #

dependencies {
    libertyRuntime group: 'com.ibm.websphere.appserver.runtime', name: 'wlp-kernel', version: '24.0.0.1'
}

liberty {
    install {
        type = 'kernel'
    }
    server {
        name = libertyServerName
        configDirectory = new File(libertyConfigDir)
        bootstrapPropertiesFile = new File("${libertyConfigDir}/bootstrap.properties")
        apps = []
        stripVersion = true
        features {
            name = [
                'microProfile-6.1'
            ]
        }
    }
}

已尝试操作 #

• 更换过多个Liberty Gradle插件版本
• 尝试过不同版本的Open Liberty
• 在不同网络环境下测试，排除网络问题
• 查阅官方文档确认microProfile-6.1特性受Open Liberty 24.0.0.1支持

排查与解决方案 #

1. 修正特性配置语法 #

Liberty Gradle插件3.0版本中，features块的数组赋值语法可能存在兼容性问题，改用feature方法逐个添加特性：

server {
    // 保留原有其他配置
    features {
        feature 'microProfile-6.1'
    }
}

2. 直接通过依赖引入特性 #

跳过installFeature任务，在dependencies中直接添加microProfile-6.1特性的依赖，让Gradle自动处理安装：

dependencies {
    libertyRuntime group: 'com.ibm.websphere.appserver.runtime', name: 'wlp-kernel', version: '24.0.0.1'
    libertyFeature group: 'io.openliberty.features', name: 'microProfile-6.1', version: '24.0.0.1'
}

添加后移除server块中的features配置，避免任务冲突。

3. 检查特性名称的完整格式 #

尝试给特性名称添加完整的组件前缀，确保插件能正确识别：

features {
    feature 'io.openliberty.features:microProfile-6.1'
}

4. 清理Liberty本地缓存 #

删除本地Liberty安装目录下的wlp/usr/extension/lib和wlp/etc/caches文件夹，重新执行Gradle任务，强制重新下载特性包。

5. 补充Gradle仓库配置 #

确保build.gradle中配置了Open Liberty特性包的合法下载源：

repositories {
    mavenCentral()
    maven {
        url 'https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/wasdev/maven/repository/'
    }
}

6. 降级Liberty Gradle插件版本 #

尝试降级到2.x系列插件版本（如2.10），部分新版本插件的特性安装逻辑可能存在兼容性问题，旧版本稳定性更强。

内容的提问来源于stack exchange，提问作者AI Workout Log