Heroku部署Node应用用libreoffice构建包报错找不到soffice二进制如何解决

环境变量加载差异 #

heroku run启动的是交互式登录shell，会自动加载所有构建包预设的环境变量（包括PATH），所以可以直接找到soffice二进制。但Heroku的web/worker dyno启动应用时使用非登录shell，部分构建包的环境变量如果未正确注入全局运行时环境，会导致应用进程的PATH中没有soffice的安装路径，触发Error: Could not find soffice binary报错。

硬编码路径不匹配 #

heroku-buildpack-libreoffice-for-heroku-18会把LibreOffice安装到/app/.apt/前缀的自定义路径下，而非系统默认的/usr/bin/。如果你的转换代码中硬编码了本地环境的soffice路径，会和Heroku的实际安装路径不匹配。

执行权限不足 #

少数场景下，应用运行用户没有soffice二进制的执行权限，即使文件存在，调用时也会被判定为找不到可执行文件。

• 首先通过heroku run bash执行which soffice，获取soffice的绝对路径，通常为/app/.apt/usr/bin/soffice
• 优先在转换代码/转换库的配置项中指定上述绝对路径，不依赖系统PATH自动查找
• 如果不想修改代码，可修改应用启动命令，提前注入路径：比如原启动命令为python app.py，修改为PATH=$PATH:/app/.apt/usr/bin python app.py
• 若调用时出现依赖库报错，可在Heroku配置变量中新增LD_LIBRARY_PATH，值设为/app/.apt/usr/lib/x86_64-linux-gnu/
• 权限问题可通过在项目的构建脚本（比如Procfile的发布钩子）中添加chmod +x /app/.apt/usr/bin/soffice解决

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