Zarządzanie dostępem do plików lokalnych dla akcji serwera Next.js 14.1 na platformie Vercel

Naprawianie problemów z dostępem do plików w akcjach serwera Next.js 14.1 przy użyciu różnych metod

Aby zapewnić bezpieczny dostęp do plików lokalnych w środowisku produkcyjnym, to rozwiązanie wykorzystuje backend Node.js z trasą 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');
  }
}

Następnie użyj konfiguracji Modular Webpack do skopiowania plików. Kompilacje produkcyjne dla JavaScript

Aby zagwarantować, że pliki lokalne zostaną prawidłowo spakowane w środowisku produkcyjnym, podejście to zmienia ustawienia pakietu 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;
  },
};

Dynamiczny dostęp do plików przy użyciu tras API zamiast akcji serwera

Dzięki tej metodzie zamiast dynamicznego dostępu do plików używamy tras API, aby zapewnić lokalne udostępnianie plików gotowe do produkcji.

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

Test jednostkowy dostępu do plików w trasie API

Ten test jednostkowy potwierdza, że ​​plik PDF jest prawidłowo obsługiwany przez trasę 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');
  });
});

Często zadawane pytania dotyczące obsługi plików lokalnych w akcjach serwera Next.js

1. Jak mogę zapewnić dostępność plików lokalnych w środowisku produkcyjnym?
2. Przez uwzględnienie CopyPlugin w konfiguracji pakietu internetowego możesz upewnić się, że zasoby lokalne, takie jak pliki PDF i czcionki, zostaną dołączone do kompilacji i udostępnione.
3. Dlaczego podczas produkcji otrzymuję błędy ENOENT?
4. Przyczyną tego błędu jest to, że w systemach takich jak Vercel pliki lub katalogi, do których próbujesz uzyskać dostęp, nie zostały uwzględnione w kompilacji produkcyjnej.
5. Chcę uzyskać dostęp do plików, ale czy mogę używać tras API zamiast działań serwera?
6. Tak, możesz mieć dodatkową kontrolę i gwarancję, że pliki zostaną poprawnie dostarczone w środowisku produkcyjnym, przenosząc funkcjonalność dostępu do plików na ścieżkę API.
7. Jaka jest rola procesu.cwd() w ścieżkach plików?
8. process.cwd() zapewnia bieżący katalog roboczy, pomagając w dynamicznym tworzeniu ścieżek plików niezależnie od zmian środowiska.
9. Czy powinienem używać @vercel/blob do przechowywania plików?
10. Chociaż @vercel/blob jest opcją, może powodować opóźnienia w procesach takich jak tworzenie plików PDF. Szybszymi opcjami mogą być trasy API lub bezpośredni dostęp do plików.

Końcowe przemyślenia na temat obsługi lokalnego dostępu do plików

Dostęp do plików lokalnych może być dużym utrudnieniem podczas korzystania z akcji serwera w Next.js 14.1, szczególnie w Vercel. Jednak programiści mogą upewnić się, że ich pliki są spakowane i dostępne w środowisku produkcyjnym, korzystając z technologii takich jak CopyPlugin i trasy API pakietu Webpack.

Możesz ominąć wszelkie problemy, koncentrując się na dynamicznych technikach obsługi plików, takich jak przeniesienie funkcjonalności plików na trasy API. Dalsze badania nad technikami dostępu do plików mogą zaowocować jeszcze skuteczniejszymi rozwiązaniami do późniejszych wdrożeń.