如何在Payara Server 6.2024.6中升级Eclipselink至4.0.3版本？

问题根源 #

错误日志明确指向OSGI版本格式不兼容：你使用的org.eclipse.persistence.oracle.jar包的Bundle-Version字段为4.0.3- SNAPSHOT.v202405161415，其中3- SNAPSHOT包含空格和非法分隔符，违反了OSGI版本规范（OSGI版本要求为主版本.次版本.微版本[.限定符]，前三个部分必须是纯数字，限定符不能包含空格或非法分隔）。

解决步骤 #

• 下载EclipseLink 4.0.3正式版JAR包，避免使用SNAPSHOT快照版本。正式版的MANIFEST文件会严格遵循OSGI版本规范，不会出现格式错误。
• 替换Payara模块：
  1. 进入Payara安装目录下的glassfish/modules文件夹，找到所有旧的EclipseLink相关JAR（如org.eclipse.persistence.core.jar、org.eclipse.persistence.oracle.jar等），先备份再删除。
  2. 将下载的正式版EclipseLink 4.0.3对应JAR复制到该目录。
• （可选）验证合规性：解压替换后的JAR，打开META-INF/MANIFEST.MF文件，确认Bundle-Version字段格式为4.0.3或4.0.3.vXXXXXXX这类合规格式，无空格和非法字符。
• 重启Payara Server，检查日志是否消除版本相关错误。

特殊情况处理（若必须用快照版本） #

如果因需求必须使用快照版，需手动修正版本号：

1. 解压问题JAR包，打开META-INF/MANIFEST.MF。
2. 将Bundle-Version字段修改为合规格式，比如把4.0.3- SNAPSHOT.v202405161415改为4.0.3.SNAPSHOT.v202405161415（移除空格，将横杠替换为点）。
3. 重新打包JAR，替换到Payara的modules目录后重启服务器。

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