Heroku已安装libreoffice buildpack仍提示soffice not found问题咨询

排查步骤 #

• 确认buildpack安装顺序是否正确，Heroku的buildpack按从上到下的顺序执行，必须把libreoffice的buildpack放在Node.js buildpack之前，否则Node.js应用构建时读取不到libreoffice的环境变量和二进制文件。
• 验证soffice二进制是否真实存在于部署环境，你可以通过Heroku CLI执行命令进入运行实例：heroku run bash -a 你的应用名，进入后执行which soffice查看是否返回可执行文件路径，如果没有返回说明buildpack实际安装失败。
• 检查环境变量是否正确加载，实例内执行echo $PATH，确认返回内容中包含libreoffice的二进制文件所在目录，通常libreoffice buildpack会把soffice路径加到PATH中，如果没有则需要手动配置。
• 确认libreoffice-convert包的配置是否正确，有没有手动硬编码了错误的soffice路径，或者关闭了读取系统PATH的配置。

解决方案 #

• 调整buildpack顺序：在Heroku应用后台的Settings页找到Buildpacks板块，拖曳libreoffice buildpack到Node.js buildpack的上方，保存后重新部署应用。
• 手动指定soffice路径：如果which soffice有返回路径，比如返回的是/app/.apt/usr/bin/soffice，你可以在调用libreoffice-convert的时候显式传入soffice路径参数，示例代码：

const libre = require('libreoffice-convert');
libre.convertAsync = require('util').promisify(libre.convert);
// 显式指定soffice路径
libre.sofficePath = '/app/.apt/usr/bin/soffice';

• 更换可靠的libreoffice安装方式：如果当前使用的buildpack安装失败，建议使用Heroku官方APT源安装libreoffice，你可以添加APT buildpack，然后在项目根目录新建Aptfile，内容写入libreoffice，重新部署即可自动安装匹配环境的libreoffice。
• 手动配置环境变量：如果PATH没有自动加载soffice路径，你可以在Heroku应用后台的Config Vars中新增PATH配置，值为/app/.apt/usr/bin:$PATH，保存后重启实例即可生效。

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