Khắc phục sự cố "Không thể tìm thấy Chrome" và Đường dẫn bộ đệm trên máy chủ bằng Node.js Puppeteer

Vượt qua những thách thức của Puppeteer trong môi trường máy chủ Node.js và Laravel

Khi chuyển từ thiết lập phát triển cục bộ sang máy chủ trực tiếp, các sự cố cấu hình không mong muốn thường phát sinh. Một vấn đề như vậy có thể gây khó chịu đặc biệt là khi một Node.js kịch bản sử dụng Người múa rối đưa ra lỗi: "Không thể tìm thấy Chrome." Điều này thường xảy ra khi chạy tập lệnh dựa trên Laravel trong tài khoản máy chủ Apache như "dữ liệu www". 🖥️

Trên máy cục bộ, các tập lệnh Laravel thực thi theo tài khoản của người dùng hiện tại, nghĩa là tất cả các quy trình Node liên quan đều tuân theo cấu hình của người dùng đó. Tuy nhiên, trên máy chủ, các quyền và đường dẫn thay đổi, dẫn đến sự phức tạp trong việc tìm kiếm Puppeteer nhị phân Chrome dựa vào. Đây là một thách thức chung đối với các nhà phát triển, vì mỗi môi trường đều có những đặc điểm và yêu cầu riêng.

Một trong những vấn đề cốt lõi đằng sau lỗi này thường là do cấu hình sai hoặc không thể truy cập được. đường dẫn bộ đệm để cài đặt Chrome. Mặc dù cài đặt thủ công Chrome dành cho Puppeteer có thể hữu ích nhưng không phải lúc nào cũng đủ để giải quyết vấn đề. Nhiều nhà phát triển nhận thấy rằng cấu hình phù hợp cho các quyền ở cấp hệ thống là chìa khóa để chạy Puppeteer một cách trơn tru trên máy chủ.

Trong bài viết này, chúng tôi sẽ chia nhỏ cách khắc phục lỗi này, khám phá lý do tại sao cấu hình đường dẫn bộ đệm lại quan trọng và chia sẻ các giải pháp thiết thực. 🛠️ Với một vài điều chỉnh đơn giản, bạn sẽ có thể chạy các tập lệnh Puppeteer một cách đáng tin cậy trên môi trường máy chủ của mình.

Hiểu và giải quyết các vấn đề về đường dẫn bộ nhớ đệm của Puppeteer trong Node.js trên máy chủ

Các tập lệnh được cung cấp trong phần trước phục vụ mục đích quan trọng là giúp Puppeteer định vị trình duyệt Chrome đã cài đặt trên máy chủ, đặc biệt khi tập lệnh Node.js được chạy bởi một tài khoản người dùng khác (chẳng hạn như “www-data” trong Apache). Một lý do chính khiến lỗi này xuất hiện là Puppeteer tìm kiếm Chrome trong đường dẫn bộ đệm mặc định thường dành riêng cho người dùng. Khi tập lệnh Node được người dùng Apache thực thi, nó không có quyền truy cập vào thư mục bộ đệm trong thư mục chính của người dùng hiện tại. Thiết lập này giúp thiết lập một đường dẫn thay thế, như /var/www/.cache/puppeteer, cần thiết để có thể truy cập Chrome bất kể người dùng đang chạy. Bằng cách tạo thư mục này với các quyền thích hợp và liên kết bộ đệm của Puppeteer với nó, chúng tôi cho phép trình duyệt Chrome được tìm thấy một cách đáng tin cậy bởi quy trình Puppeteer chạy trong Apache.

Một trong những bước đầu tiên mà tập lệnh thực hiện là đảm bảo thư mục bộ đệm tồn tại bằng cách sử dụng fs.mkdirSync với tùy chọn đệ quy. Điều này đảm bảo rằng mọi thư mục mẹ cần thiết đều được tạo chỉ trong một lần. Sau khi tạo thư mục, tập lệnh sẽ đặt PUPPETEER_CACHE biến môi trường vào đường dẫn cài đặt Chrome. Biến môi trường này rất quan trọng vì nó ghi đè đường dẫn bộ đệm mặc định của Puppeteer, đảm bảo rằng nó luôn tìm trong đường dẫn thân thiện với máy chủ được chỉ định thay vì đường dẫn dành riêng cho người dùng. Ví dụ: nếu bạn đang làm việc trên một máy chủ chạy thử và muốn đảm bảo Puppeteer hoạt động nhất quán trên nhiều tài khoản, việc đặt biến môi trường thành một vị trí dùng chung sẽ ngăn các lỗi liên quan đến việc thiếu tệp thực thi.

Khi khởi chạy Puppeteer trong các tập lệnh này, chúng tôi chỉ định đường dẫn thực thi tham số để cung cấp đường dẫn trực tiếp tới tệp nhị phân của Chrome. Điều này bỏ qua nhu cầu tìm kiếm trong nhiều thư mục của Puppeteer, việc này có thể không thành công với một số quyền nhất định. Một lệnh hữu ích khác có trong tập lệnh là args: ['--no-sandbox'], một đối số thường được yêu cầu trong môi trường máy chủ. Chế độ hộp cát, được bật theo mặc định, đôi khi có thể gây trở ngại cho người dùng không phải root hoặc hạn chế quyền trong một số cấu hình máy chủ nhất định. Bằng cách thêm đối số này, chúng tôi cho phép Puppeteer khởi chạy Chrome mà không cần hộp cát, điều này giải quyết nhiều lỗi liên quan đến quyền trong môi trường máy chủ Linux. 🖥️

Cuối cùng, để đảm bảo giải pháp hoạt động đáng tin cậy, chúng tôi đã cung cấp các bài kiểm tra đơn vị. Những thử nghiệm này sử dụng các lệnh như fs.rmdirSync để đặt lại thư mục bộ nhớ đệm, đảm bảo một phương tiện chặn rõ ràng trước khi chạy thử nghiệm nhằm xác thực chức năng của tập lệnh. Ngoài ra, quá trình kiểm tra sẽ kiểm tra xem trình duyệt có khởi chạy thành công hay không bằng cách xác minh rằng Puppeteer có thể định vị Chrome trong đường dẫn đã chỉ định. Điều này rất cần thiết đối với các máy chủ có triển khai tự động vì nó xác nhận rằng cấu hình trình duyệt sẽ hoạt động trong sản xuất mà không cần điều chỉnh thủ công. Ví dụ: trong thiết lập tích hợp liên tục, các thử nghiệm này có thể chạy mỗi khi mã được triển khai, giúp nhà phát triển tin tưởng rằng cấu hình của Puppeteer vẫn nguyên vẹn, ngăn ngừa những bất ngờ không mong muốn trong môi trường trực tiếp. 🛠️

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);
    }
})();

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);
    }
})();

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();
    });
});

Giải quyết lỗi Puppeteer và đường dẫn Chrome trong môi trường nhiều người dùng

Một trong những thách thức khi sử dụng Người múa rối trong môi trường máy chủ đang đảm bảo chính xác đường dẫn bộ đệm dành cho Chrome, đặc biệt khi tập lệnh chạy dưới một tài khoản người dùng khác, chẳng hạn như "dữ liệu www" của Apache. Thiết lập này thường làm phức tạp cấu hình vì tài khoản "dữ liệu www" có thể không truy cập được đường dẫn bộ đệm Puppeteer mặc định. Khi Puppeteer không tìm thấy tệp nhị phân của Chrome, điều này thường dẫn đến lỗi "Không thể tìm thấy Chrome" ngay cả khi Chrome đã được cài đặt trước đó. Việc định cấu hình đường dẫn bộ đệm theo cách thủ công hoặc đặt các biến môi trường có thể giải quyết vấn đề này bằng cách đảm bảo Puppeteer tìm trong thư mục được chia sẻ giữa những người dùng, chẳng hạn như /var/www/.cache/puppeteer.

Một khía cạnh khác cần xem xét là thiết lập các đối số khởi chạy cụ thể cho Puppeteer trong môi trường máy chủ. Ví dụ: vô hiệu hóa hộp cát Chrome bằng args: ['--no-sandbox'] giúp tránh các vấn đề về quyền trên máy chủ Linux, vốn không phải lúc nào cũng xử lý tốt hộp cát đối với người dùng không có quyền root. Tùy chọn này, cùng với việc chỉ định đường dẫn thực thi tùy chỉnh, cải thiện khả năng tương thích của Puppeteer với môi trường máy chủ. Khi thiết lập cục bộ, bạn có thể không gặp phải những sự cố này vì Puppeteer chạy với quyền của người dùng hiện tại, nhưng trong quá trình sản xuất, người dùng "dữ liệu www" hạn chế hơn sẽ không có quyền truy cập vào một số tài nguyên trừ khi chúng được định cấu hình rõ ràng.

Cuối cùng, khi triển khai các tập lệnh trong môi trường dùng chung hoặc môi trường sản xuất, bạn nên tự động hóa các cấu hình này. Tự động hóa các bước như thiết lập đường dẫn bộ đệm và cài đặt Chrome bằng lệnh như npx puppeteer browsers install đảm bảo rằng mỗi lần triển khai đều được chuẩn bị để chạy Puppeteer mà không cần can thiệp thủ công. Ngoài ra, việc thêm các thử nghiệm để xác minh rằng Chrome khởi chạy chính xác có thể ngăn chặn thời gian ngừng hoạt động do cấu hình sai. Những điều chỉnh này rất cần thiết để xây dựng một môi trường ổn định trong đó Puppeteer hoạt động như mong đợi, bất kể tài khoản người dùng đang chạy tập lệnh. 🛠️