在Vercel上部署md-to-pdf项目的Chromium解决方案

在Vercel上部署md-to-pdf项目的Chromium解决方案

【免费下载链接】md-to-pdf Hackable CLI tool for converting Markdown files to PDF using Node.js and headless Chrome. 项目地址: https://gitcode.com/gh_mirrors/md/md-to-pdf

问题背景

当开发者尝试在Vercel平台上部署使用md-to-pdf库的项目时，经常会遇到一个典型错误："Could not find Chrome"。这个问题源于Vercel平台对Serverless函数大小的限制（50MB），而完整的Chromium浏览器二进制文件通常会超过这个限制。

核心解决方案

经过实践验证，最有效的解决方案是使用专门为Serverless环境优化的@sparticuz/chromium包。以下是具体实现步骤：

1. 安装依赖： 首先需要安装适配Vercel环境的Chromium包：

   npm install @sparticuz/chromium
   

2. Next.js配置： 在next.config.mjs文件中添加必要的配置：

   const nextConfig = {
     experimental: {
       serverComponentsExternalPackages: ['md-to-pdf', '@sparticuz/chromium'],
     },
   };
   

3. 环境区分处理： 由于开发环境和生产环境需要不同的Chromium配置，建议实现环境检测逻辑：

   const isProduction = process.env.NODE_ENV === 'production';
   

详细实现方案

Chromium配置

对于生产环境，需要进行专门的Chromium设置：

if (isProduction) {
  chromium.setGraphicsMode = false;
  // 可在此处加载自定义字体
}

启动选项配置

根据环境不同提供不同的启动参数：

const launchOptions = isProduction
  ? {
      args: chromium.args,
      defaultViewport: chromium.defaultViewport,
      executablePath: await chromium.executablePath(),
      headless: chromium.headless,
    }
  : {};

PDF生成调用

最终调用mdToPdf方法时传入配置：

const pdf = await mdToPdf(
  { content },
  {
    stylesheet: [process.cwd() + '/node_modules/md-to-pdf/markdown.css'],
    launch_options: launchOptions,
  }
);

高级配置技巧

1. 阻止Puppeteer自动下载Chromium： 可以通过环境变量或配置文件阻止不必要的Chromium下载：

   // puppeteer.config.js
   export default {
     skipDownload: true
   }
   

2. 自定义样式表： 开发者可以轻松替换默认样式表，只需在options中指定新的stylesheet路径。

3. 字体处理： 虽然emoji渲染在Serverless环境中可能存在挑战，但可以通过chromium.font()方法加载特定字体。

注意事项

1. 开发环境和生产环境需要不同的处理方式，@sparticuz/chromium通常不适用于本地开发。

2. 样式定制时，建议先测试默认样式是否满足需求，再考虑自定义样式。

3. 对于复杂的内容渲染（如emoji），可能需要额外的字体配置和测试。

通过以上方案，开发者可以成功在Vercel平台上部署使用md-to-pdf库的项目，同时避免了Chromium二进制文件大小限制的问题。这种方案不仅解决了部署问题，还提供了良好的开发体验和灵活性。

【免费下载链接】md-to-pdf Hackable CLI tool for converting Markdown files to PDF using Node.js and headless Chrome. 项目地址: https://gitcode.com/gh_mirrors/md/md-to-pdf