Správa místního přístupu k souborům pro Next.js 14.1 Server Actions na Vercelu

Oprava problémů s přístupem k souborům v Next.js 14.1 Akce serveru pomocí různých metod

Pro bezpečný přístup k místním souborům v produkci toto řešení využívá backend Node.js s trasou 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');
  }
}

Dále použijte konfiguraci Modular Webpack ke zkopírování souborů.Produkce Builds for JavaScript

Aby bylo zaručeno, že místní soubory budou v produkci správně spojeny, tento přístup mění nastavení Webpacku.

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;
  },
};

Dynamický přístup k souborům pomocí tras API namísto akcí serveru

S touto metodou používáme trasy API namísto dynamického přístupu k souborům, abychom zajistili místní poskytování souborů připravených pro produkci.

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

Unit Test pro přístup k souboru v API Route

Tento test jednotky potvrzuje, že soubor PDF je správně obsluhován cestou 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');
  });
});

Běžné otázky o manipulaci s místními soubory v akcích serveru Next.js

1. Jak mohu zajistit dostupnost místních souborů v produkci?
2. Zahrnout CopyPlugin v konfiguraci Webpacku můžete zajistit, že místní zdroje, jako jsou soubory PDF a písma, budou součástí sestavení a zpřístupněny.
3. Proč se mi ve výrobě zobrazují chyby ENOENT?
4. Důvodem této chyby je, že v systémech, jako je Vercel, nebyly soubory nebo adresáře, ke kterým se pokoušíte získat přístup, zahrnuty do produkčního sestavení.
5. Chci přistupovat k souborům, ale mohu místo akcí serveru používat trasy API?
6. Ano, můžete mít další kontrolu a záruku, že soubory jsou v produkčním prostředí poskytovány správně, přenesením funkce přístupu k souboru do trasy API.
7. Jaká je role process.cwd() v cestách k souboru?
8. process.cwd() poskytuje aktuální pracovní adresář a pomáhá při dynamickém vytváření cest k souborům nezávisle na variacích prostředí.
9. Mám pro ukládání souborů používat @vercel/blob?
10. Ačkoli je @vercel/blob možnost, může způsobit zpoždění procesů, jako je tvorba PDF. Rychlejšími možnostmi mohou být trasy API nebo přímý přístup k souborům.

Závěrečné myšlenky na zacházení s místním přístupem k souborům

Při použití akcí serveru v Next.js 14.1 může být přístup k místním souborům velkým problémem, zejména na Vercelu. Vývojáři se však mohou ujistit, že jejich soubory jsou zabaleny a dostupné v produkci pomocí technologií, jako je CopyPlugin a trasy API Webpack.

Můžete se vyhnout jakýmkoli problémům tím, že se soustředíte na dynamické techniky zpracování souborů, jako je přesunutí funkčnosti souborů na trasy API. Další výzkum technik přístupu k souborům může vyústit v ještě efektivnější řešení pro pozdější nasazení.