Управление доступом к локальным файлам для действий сервера Next.js 14.1 на Vercel

Исправление проблем доступа к файлам в действиях сервера Next.js 14.1 с использованием различных методов

Для безопасного доступа к локальным файлам в рабочей среде это решение использует серверную часть Node.js с маршрутом API.

const { PDFDocument } = require('pdf-lib');
const fs = require('fs');
const path = require('path');
export default async function handler(req, res) {
  try {
    const pdfDataDir = path.join(process.cwd(), 'actions', 'pdf_data');
    const templatePath = path.join(pdfDataDir, 'template.pdf');
    const pdfDoc = await PDFDocument.load(fs.readFileSync(templatePath));
    const pdfBytes = await pdfDoc.save();
    res.setHeader('Content-Type', 'application/pdf');
    res.status(200).send(pdfBytes);
  } catch (error) {
    res.status(500).send('Error generating PDF');
  }
}

Затем используйте конфигурацию модульного веб-пакета для копирования файлов. Производственные сборки для JavaScript.

Чтобы гарантировать, что локальные файлы будут правильно упакованы в рабочей среде, этот подход изменяет настройки Webpack.

const CopyPlugin = require('copy-webpack-plugin');
const path = require('path');
module.exports = {
  webpack: (config, { dev, isServer }) => {
    if (!dev && isServer) {
      config.plugins.push(
        new CopyPlugin({
          patterns: [{
            from: path.join(__dirname, 'actions', 'pdf_data'),
            to: path.join(__dirname, '.next', 'server', 'actions', 'pdf_data'),
          }],
        })
      );
    }
    return config;
  },
};

Динамический доступ к файлам с использованием маршрутов API вместо действий сервера

С помощью этого метода мы используем маршруты API вместо динамического доступа к файлам, чтобы обеспечить готовое к работе локальное обслуживание файлов.

import { promises as fs } from 'fs';
import path from 'path';
export default async function handler(req, res) {
  try {
    const pdfDataDir = path.join(process.cwd(), 'actions', 'pdf_data');
    const filePath = path.join(pdfDataDir, 'template.pdf');
    const file = await fs.readFile(filePath);
    res.setHeader('Content-Type', 'application/pdf');
    res.status(200).send(file);
  } catch (err) {
    res.status(500).send('Error loading file');
  }
}

Модульный тест доступа к файлам в маршруте API

Этот модульный тест подтверждает, что PDF-файл надлежащим образом обслуживается по маршруту API.

import handler from '../pages/api/generate-pdf';
import { createMocks } from 'node-mocks-http';
describe('PDF Generation API', () => {
  it('should return a PDF', async () => {
    const { req, res } = createMocks({ method: 'GET' });
    await handler(req, res);
    expect(res._getStatusCode()).toBe(200);
    expect(res._getHeaders()['content-type']).toBe('application/pdf');
  });
});

Общие вопросы по обработке локальных файлов в действиях сервера Next.js

1. Как я могу гарантировать доступность локальных файлов в рабочей среде?
2. По включению CopyPlugin в конфигурации Webpack вы можете гарантировать, что локальные ресурсы, такие как PDF-файлы и шрифты, будут включены в сборку и станут доступными.
3. Почему я получаю ошибки ENOENT в производстве?
4. Причина этой ошибки заключается в том, что в таких системах, как Vercel, файлы или каталоги, к которым вы пытаетесь получить доступ, не были включены в производственную сборку.
5. Я хочу получить доступ к файлам, однако могу ли я использовать маршруты API вместо действий сервера?
6. Да, вы можете иметь дополнительный контроль и гарантировать правильность предоставления файлов в производственной среде, перенеся функции доступа к файлам на маршрут API.
7. Какова роль процесса.cwd() в путях к файлам?
8. process.cwd() предоставляет текущий рабочий каталог, помогая динамически создавать пути к файлам независимо от изменений среды.
9. Должен ли я использовать @vercel/blob для хранения файлов?
10. Хотя @vercel/blob является опцией, это может привести к задержке таких процессов, как создание PDF-файлов. Более быстрыми вариантами могут быть маршруты API или прямой доступ к файлам.

Заключительные мысли по управлению доступом к локальным файлам

Доступ к локальным файлам может стать большой проблемой при использовании действий сервера в Next.js 14.1, особенно в Vercel. Однако разработчики могут быть уверены, что их файлы упакованы и доступны в рабочей среде, используя такие технологии, как CopyPlugin Webpack и маршруты API.

Вы можете избежать любых проблем, сосредоточившись на методах динамической обработки файлов, таких как перенос функциональности файлов на маршруты API. Дальнейшие исследования методов доступа к файлам могут привести к созданию еще более эффективных решений для последующих развертываний.