全新安装WSO2 Identity Server时出现模块导入错误

问题现象 #

全新安装的WSO2 Identity Server未做任何配置，在OpenJDK11和OpenJDK17环境下启动时均触发以下错误：

[2023-09-08 16:21:46,866] [] ERROR {Events.Framework} - FrameworkEvent ERROR org.osgi.framework.BundleException: Could not resolve module: org.wso2.carbon.identity.application.authenticator.oidc [266]
Unresolved requirement: Import-Package: org.wso2.carbon.identity.oauth2.util; version="[6.0.0,7.0.0)"
Unresolved requirement: Import-Package: org.wso2.carbon.identity.oauth2; version="[6.0.0,7.0.0)"

操作流程：

• 解压身份服务器压缩包
• 设置环境变量
• 执行bin/wso2server.sh启动服务后报错

预期结果：自定义配置前服务可正常启动，或给出配置类错误提示

排查与解决步骤 #

1. 验证安装包完整性 #

下载过程中文件损坏可能导致OAuth2相关依赖缺失：

• 重新下载对应版本的WSO2 Identity Server安装包
• 通过官方提供的SHA-256校验值验证安装包完整性
• 重新解压验证后的安装包，再尝试启动

2. 检查环境变量配置 #

• 确认JAVA_HOME指向正确的OpenJDK11/17路径，路径中无空格或特殊字符
• 检查CARBON_HOME是否设置为解压后的WSO2根目录
• 启动前执行echo $JAVA_HOME和echo $CARBON_HOME确认变量配置正确

3. 核对依赖包版本 #

错误提示OIDC认证器模块依赖[6.0.0,7.0.0)版本的OAuth2相关包：

• 进入<CARBON_HOME>/repository/components/plugins目录，查找org.wso2.carbon.identity.oauth2*.jar和org.wso2.carbon.identity.oauth2.util*.jar文件
• 若缺失，从官方对应版本组件库获取匹配包放入该目录
• 若版本不匹配，替换为符合版本范围的包文件

4. 清理OSGi缓存 #

缓存异常可能干扰依赖解析：

• 停止运行中的服务
• 删除<CARBON_HOME>/repository/components/temp和<CARBON_HOME>/repository/components/org.eclipse.osgi目录
• 重新执行bin/wso2server.sh启动服务

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