You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

NestJS应用中无法从自定义Uploads文件夹下载文件怎么办?

解决NestJS自定义Uploads文件夹静态资源访问问题

NestJS默认仅将public文件夹设为可直接访问的静态资源目录,要让自定义的Uploads文件夹支持外部访问,可通过以下两种方式配置:

方式一:通过ServeStaticModule配置

在项目根模块(通常是AppModule)中导入ServeStaticModule,添加Uploads文件夹的静态资源映射规则:

import { Module } from '@nestjs/common';
import { ServeStaticModule } from '@nestjs/serve-static';
import { join } from 'path';

@Module({
  imports: [
    // 配置Uploads文件夹的静态访问
    ServeStaticModule.forRoot({
      rootPath: join(__dirname, '..', 'Uploads'), // 根据项目结构调整路径,此处假设Uploads与src同级
      serveRoot: '/Uploads', // 对应访问URL的前缀
    }),
    // 保留原public文件夹的访问配置(如果需要)
    ServeStaticModule.forRoot({
      rootPath: join(__dirname, '..', 'public'),
      serveRoot: '/',
    }),
  ],
})
export class AppModule {}

配置完成后重启服务,即可通过http://localhost:3000/Uploads/file.png访问目标文件。

方式二:使用Express静态中间件

如果你的NestJS使用默认的Express适配器,可直接在main.ts中挂载Express的静态资源中间件:

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import * as express from 'express';
import { join } from 'path';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 将Uploads文件夹挂载为/Uploads路径的静态资源
  app.use('/Uploads', express.static(join(__dirname, '..', 'Uploads')));
  await app.listen(3000);
}
bootstrap();

额外注意事项

  • 确认Uploads文件夹已存在,且文件确实被上传到了该目录下
  • 检查文件夹和文件的权限,确保Node.js进程拥有读取权限
  • 如果项目设置了全局路由前缀(如app.setGlobalPrefix('api')),访问URL需要加上前缀,例如http://localhost:3000/api/Uploads/file.png

内容的提问来源于stack exchange,提问作者mevr

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.23 06:24:46