Vercel部署Laravel项目：ChromePHP找不到Chrome可执行文件求助

关于将Chrome安装目录放入项目的可行性 #

直接将本地Chrome目录放入项目不可行，原因有二：

• Chrome体积超过200MB，会大幅增加项目包大小，拖慢部署速度；
• 本地Chrome是Windows/macOS版本，与Vercel的Linux部署环境不兼容，无法运行。即使放入Linux版本的Chrome，后续维护和更新也会非常麻烦，因此不推荐这种做法。

可行解决方案 #

1. 在Vercel构建时安装Chromium #

Vercel的部署环境基于Ubuntu，可通过构建命令自动安装开源版Chrome（Chromium）：

• 修改项目根目录的package.json，在build命令前添加安装步骤：

"scripts": {
  "build": "apt-get update && apt-get install -y chromium-browser && php artisan optimize:clear"
}

• 在Laravel代码中指定Chromium的路径（Ubuntu中默认路径为/usr/bin/chromium-browser）：

// 在使用ChromePHP前设置路径
ChromePHP::setChromePath('/usr/bin/chromium-browser');

2. 通过环境变量配置Chrome路径 #

避免硬编码路径，可在Vercel项目的「Settings → Environment Variables」中添加变量：

• 变量名：CHROME_PATH
• 变量值：/usr/bin/chromium-browser
• 代码中读取环境变量：

ChromePHP::setChromePath(env('CHROME_PATH', '/usr/bin/chromium-browser'));

3. 使用第三方无头浏览器服务 #

如果不想在Vercel环境中安装浏览器，可将无头浏览器操作转发到第三方服务，只需在代码中配置远程服务地址：

ChromePHP::setRemoteUrl('https://your-browserless-service-endpoint');

此方案无需在部署环境维护浏览器，但需要额外的服务订阅费用。

4. 适配Vercel Serverless Functions（针对API场景） #

如果ChromePHP用于API路由，可将相关逻辑封装为Vercel Serverless Function，在函数目录下的package.json中添加依赖并配置构建脚本，确保Chromium在函数部署时被安装。

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