Azure流水线调用GitHub Jar包及lowriter转PDF报错如何解决

不存在完全不落地到本地文件系统即可直接运行java -jar的方法。
java -jar命令的底层逻辑要求必须从本地可访问的文件系统路径读取Jar包的清单配置、类文件、依赖资源，不支持直接传入HTTP/HTTPS远程地址作为Jar包入参，这也是最初直接调用远程Jar报Error:Unable to access jarfile的根本原因。
当前采用wget预下载Jar再执行的方案是通用可行方案，如果不想在Azure环境长期留存Jar包，只需要在Jar执行完成后追加删除命令rm -f test.jar即可，Jar包仅在流水线运行的临时生命周期内存在，不会产生持久存储占用。

已确认工作目录正确、目标文件存在的前提下，按以下优先级排查修复：

• 修复文件权限：Azure流水线执行任务的用户身份默认可能没有生成文件的读权限，先执行ls -l report.docx查看权限位，若无读权限执行chmod +r report.docx授权后重试。
• 等待文件句柄释放：Jar包生成docx的进程退出时可能未完全释放文件锁，lowriter读取时文件处于占用状态，可在Jar执行命令和转换命令之间加sleep 3等待资源释放后再转换。
• 补全运行依赖：最小化安装的Linux流水线环境常缺少LibreOffice headless模式运行所需的组件和中文字体，先执行lowriter --version验证命令本身可正常运行，若报错则补全对应依赖：Debian/Ubuntu系安装libreoffice-core libreoffice-writer fonts-wqy-zenhei，RHEL/CentOS系安装libreoffice-headless libreoffice-writer wqy-zenhei-fonts。
• 调整转换命令参数：流水线默认常以root身份运行任务，LibreOffice默认限制root用户直接加载用户配置，可指定临时配置目录绕过限制，转换命令修改为：

mkdir -p /tmp/lo_tmp
lowriter --headless --norestore --convert-to pdf report.docx --env:UserInstallation=file:///tmp/lo_tmp

• 校验文件完整性：将流水线生成的report.docx下载到本地用办公软件打开测试，若本地也无法打开，说明是Jar包生成文档的环节存在问题，和转换命令无关。

内容的提问来源于stack exchange，提问作者P.T