Git-annex管理的项目提交后Java无法运行的问题求助

问题背景 #

我有一个由DataLad（Git和Git-annex的前端工具）管理的科研项目，包含代码和用于可复现性的Singularity容器。手动安装Java后最初能正常运行java -version，但执行git annex add <java_dir>、git add .和git commit提交更改后，Java无法启动，报错如下：

Error: could not find libjava.so
Error: Could not find Java SE Runtime Environment.

附录：Java安装步骤 #

mkdir lib
cd lib
wget https://javadl.oracle.com/webapps/download/AutoDL?BundleId=246799_424b9da4b48848379167015dcc250d8d -O jre_8_341.tgz
tar -xf ./jre_8_341.tgz # creates jre1.8.0_341/
rm jre_8_341.tgz
cd jre1.8.0_341/bin

解决方案 #

1. 取消Git-annex对Java目录的托管（最简单） #

Git-annex会将托管文件替换为符号链接，而Java运行时依赖的库路径多为相对路径或硬编码，符号链接会破坏这些依赖关系。

• 执行以下命令取消Java目录的annex托管：

  git annex unannex <java_dir>
  

• 将Java目录加入.gitignore，避免后续误提交：

  echo "lib/jre1.8.0_341/" >> .gitignore
  git add .gitignore
  git commit -m "Ignore Java installation directory"
  

• 后续建议将Java安装到项目外的系统路径，或用Singularity容器封装（见下文）。

2. 用Singularity容器封装Java环境（推荐，符合可复现性） #

既然项目已使用Singularity，直接在容器内预装Java是更合理的方案，既隔离环境，又避免Git-annex的影响：

• 修改Singularity定义文件，在%post段添加Java安装步骤：

  %post
  mkdir -p /opt/lib
  cd /opt/lib
  wget https://javadl.oracle.com/webapps/download/AutoDL?BundleId=246799_424b9da4b48848379167015dcc250d8d -O jre_8_341.tgz
  tar -xf jre_8_341.tgz
  rm jre_8_341.tgz
  echo 'export PATH=/opt/lib/jre1.8.0_341/bin:$PATH' >> /etc/bash.bashrc
  

• 重新构建容器，运行时直接调用容器内的Java即可。

3. 若必须在项目内托管Java，切换Git-annex到Direct模式 #

Direct模式下Git-annex不会创建符号链接，而是直接管理文件，能解决路径依赖问题，但该模式不适合多设备同步场景：

• 切换到Direct模式：

  git annex direct
  

• 重新添加并提交Java目录：

  git annex add <java_dir>
  git add .
  git commit -m "Add Java directory in direct mode"
  

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