本文将介绍如何在 Nuxt 3 应用中处理用户上传的文件，并确保它们能够被正确访问。我们将探讨避免直接将上传文件存储在 public 目录下的原因，并提供一种使用 API 端点服务这些文件的解决方案，从而解决构建后文件无法访问的问题.
在 Nuxt 3 应用中，处理用户上传的文件并使其可访问，是一个常见的需求。然而，直接将上传的文件存储在 public 目录下，可能会导致一些问题，尤其是在执行 yarn build 构建生产环境后。
问题分析：为什么 public 目录不适合存储动态上传的文件？
public 目录在 Nuxt 3 中主要用于存放静态资源，例如 favicon.ico、图片、字体等。这些资源在构建时会被复制到最终的 dist 目录，并由服务器直接提供。Nuxt 3 假定 public 目录下的文件在构建后不会发生变化。
因此，如果在运行时将用户上传的文件动态地添加到 public 目录，这些文件不会被包含在构建过程中，导致在生产环境中无法访问，出现 404 错误。
解决方案：使用 API 端点服务上传的文件
一个更可靠的解决方案是创建一个 API 端点来服务这些上传的文件。这样做可以绕过 Nuxt 3 的静态资源处理机制，并允许你动态地提供文件。
以下是一个简单的实现步骤：
创建 API 路由： 在 server/api 目录下创建一个新的 API 路由，例如 server/api/files/[filename].ts。
-
读取文件并返回： 在 API 路由中，使用 fs 模块读取文件，并将其作为响应返回。
import { defineEventHandler } from 'h3' import fs from 'node:fs' import path from 'node:path' export default defineEventHandler(async (event) => { const filename = event.context.params?.filename if (!filename) { throw createError({ statusCode: 400, statusMessage: 'Filename is required' }) } const filePath = path.join(process.cwd(), 'uploads', filename) // 假设文件存储在项目根目录下的 uploads 文件夹 try { const fileBuffer = fs.readFileSync(filePath) setHeader(event, 'Content-Type', 'image/jpeg') // 根据文件类型设置正确的 Content-Type return fileBuffer } catch (error:any) { console.error(error) throw createError({ statusCode: 404, statusMessage: 'File not found' }) } }) 上传文件到指定目录： 确保上传文件时，将其保存到服务器上的一个安全目录，例如项目根目录下的 uploads 文件夹。 重要提示： 该目录不应该在 public 目录下。
前端访问： 在前端，可以使用
这样的方式访问上传的文件。
代码示例：文件上传 API 端点 (server/api/upload.ts)
import { defineEventHandler, readMultipartFormData } from 'h3'
import fs from 'node:fs'
import path from 'node:path'
export default defineEventHandler(async (event) => {
const formData = await readMultipartFormData(event)
if (!formData) {
throw createError({ statusCode: 400, statusMessage: 'No file uploaded' })
}
const file = formData.find(part => part.name === 'file')
if (!file || !file.filename || !file.data) {
throw createError({ statusCode: 400, statusMessage: 'Invalid file data' })
}
const filename = file.filename;
const filePath = path.join(process.cwd(), 'uploads', filename)
try {
fs.writeFileSync(filePath, file.data);
return { message: 'File uploaded successfully', filename };
} catch (error:any) {
console.error(error)
throw createError({ statusCode: 500, statusMessage: 'Failed to upload file' })
}
})重要安全提示：
- 文件类型验证： 在 API 端点中，务必验证上传文件的类型，防止恶意文件上传。
- 文件名安全： 对文件名进行安全处理，防止路径遍历攻击。 可以使用 path.basename() 来获取文件名，避免包含路径信息。
- 文件大小限制： 限制上传文件的大小，防止服务器资源被滥用。
总结
通过使用 API 端点来服务用户上传的文件，可以避免直接操作 public 目录带来的问题，并提供更灵活和安全的文件处理方式。 记住，public 目录主要用于存放静态资源，而动态生成的文件应该通过 API 端点来管理和提供。 这种方法确保了文件在开发和生产环境中都能正确访问，并为文件管理提供了更大的灵活性。
