使用 Node.js Puppeteer 修复服务器上的“无法找到 Chrome”和缓存路径问题

解决方案 1：安装 Chrome 并为 Apache 用户提供正确的权限

方法：Node.js 后端脚本为 www-data 用户安装和配置 Puppeteer。

const puppeteer = require('puppeteer');
const fs = require('fs');
const path = '/var/www/.cache/puppeteer';

// Ensure the cache directory exists with appropriate permissions
function ensureCacheDirectory() {
    if (!fs.existsSync(path)) {
        fs.mkdirSync(path, { recursive: true });
        console.log('Cache directory created.');
    }
}

// Launch Puppeteer with a custom cache path
async function launchBrowser() {
    ensureCacheDirectory();
    const browser = await puppeteer.launch({
        headless: true,
        executablePath: '/usr/bin/google-chrome-stable',
        userDataDir: path,
    });
    return browser;
}

// Main function to handle the process
(async () => {
    try {
        const browser = await launchBrowser();
        const page = await browser.newPage();
        await page.goto('https://example.com');
        console.log('Page loaded successfully');
        await browser.close();
    } catch (error) {
        console.error('Error launching browser:', error);
    }
})();

解决方案 2：使用环境变量和路径设置配置 Puppeteer

方法：使用 Puppeteer 缓存路径的环境变量进行后端配置的 Node.js 脚本

const puppeteer = require('puppeteer');
require('dotenv').config();

// Load cache path from environment variables
const CACHE_PATH = process.env.PUPPETEER_CACHE_PATH || '/var/www/.cache/puppeteer';
process.env.PUPPETEER_CACHE = CACHE_PATH;

// Ensure directory exists
const fs = require('fs');
if (!fs.existsSync(CACHE_PATH)) {
    fs.mkdirSync(CACHE_PATH, { recursive: true });
}

// Launch Puppeteer with environment-based cache path
async function launchBrowser() {
    const browser = await puppeteer.launch({
        headless: true,
        args: ['--no-sandbox'],
        executablePath: '/usr/bin/google-chrome-stable',
    });
    return browser;
}

(async () => {
    try {
        const browser = await launchBrowser();
        console.log('Browser launched successfully');
        await browser.close();
    } catch (error) {
        console.error('Launch error:', error);
    }
})();

解决方案 3：对 Puppeteer 缓存和启动功能进行单元测试

方法：Node.js 单元测试来验证 Puppeteer 缓存目录设置和浏览器启动功能

const { exec } = require('child_process');
const puppeteer = require('puppeteer');
const fs = require('fs');
const path = '/var/www/.cache/puppeteer';

describe('Puppeteer Configuration Tests', () => {
    it('should create cache directory if missing', (done) => {
        if (fs.existsSync(path)) fs.rmdirSync(path, { recursive: true });
        exec('node setupScript.js', (error) => {
            if (error) return done(error);
            expect(fs.existsSync(path)).toBe(true);
            done();
        });
    });

    it('should launch Puppeteer successfully', async () => {
        const browser = await puppeteer.launch({
            headless: true,
            executablePath: '/usr/bin/google-chrome-stable',
            userDataDir: path,
        });
        expect(browser).toBeDefined();
        await browser.close();
    });
});

有关 Puppeteer 和 Chrome 配置的常见问题

1. 为什么 Puppeteer 在我的服务器上找不到 Chrome？
2. 这通常发生是因为默认 cache path “www-data”用户无法访问 Chrome。尝试将 Puppeteer 配置为使用共享目录，例如 /var/www/.cache/puppeteer。
3. 如何为 Puppeteer 设置自定义缓存路径？
4. 您可以通过定义来设置自定义缓存路径 process.env.PUPPETEER_CACHE 环境变量并将其指向运行该脚本的所有用户都可以访问的目录。
5. “无沙箱”是什么意思，为什么有必要？
6. 使用 args: ['--no-sandbox'] 选项禁用 Chrome 的沙盒模式，这可以防止服务器环境中的权限问题，特别是对于非 root 用户。
7. 如何检查 Puppeteer 是否已正确安装 Chrome？
8. 您可以通过运行来验证安装 npx puppeteer browsers install 在执行 Puppeteer 脚本的同一用户下，例如 Apache 设置中的“www-data”。
9. 我可以自动为每个部署设置缓存路径吗？
10. 是的，通过将安装脚本添加到使用以下命令的部署管道中 fs.mkdirSync 用于缓存创建和 npx puppeteer browsers install 用于 Chrome 安装。
11. 在生产服务器上禁用 Chrome 沙箱是否安全？
12. 虽然禁用沙箱可以解决权限问题，但通常仅在必要时才建议这样做，因为它会稍微降低安全性。对于安全的环境，如果可能的话，探索替代方案。
13. Puppeteer 需要什么权限才能运行 Chrome？
14. Puppeteer 需要对配置中指定的缓存和用户数据目录进行读写访问，特别是当它们设置为非默认位置时。
15. 我可以在 Puppeteer 中使用其他浏览器而不是 Chrome 吗？
16. 是的，Puppeteer 支持其他基于 Chromium 的浏览器，例如 Brave，并且部分支持 Firefox。但是，请确保与脚本的要求兼容。
17. 设置后如何验证 Puppeteer 是否配置正确？
18. 运行单元测试来检查缓存目录是否存在并使用 Puppeteer 验证 Chrome 启动，有助于确保所有内容都配置正确。
19. 为什么本地开发不会出现这个错误？
20. 在本地设置中，当前用户可能可以直接访问默认缓存路径，而在服务器上，Apache 用户“www-data”可能无法在没有特定配置的情况下访问某些资源。
21. 配置 Puppeteer 需要哪些环境变量？
22. 关键环境变量包括 PUPPETEER_CACHE 用于设置缓存路径，并且可选地， PUPPETEER_EXECUTABLE_PATH 指定自定义 Chrome 二进制位置。

总结解决 Puppeteer Chrome 错误的关键步骤

对于使用 Puppeteer 遇到“无法找到 Chrome”错误的开发者来说，调整 Chrome 的缓存路径和可执行权限至关重要。使用环境变量等命令来设置 PUPPETEER_CACHE 并配置 args: ['--无沙箱'] 确保不同用户帐户的可靠访问。 🖥️

无论是在登台、生产还是其他共享服务器中进行设置，通过单元测试验证配置都可以增加强大的保证层。这些步骤使 Puppeteer 能够顺利定位 Chrome 并可靠地执行脚本，从而能够不间断地自动执行浏览器任务。 🛠️