koa实现图片上传接口(本地生成)

目录结构

my-koa-app/
├── config/               # 配置文件夹
│   └── database.js       # 数据库连接配置
├── controllers/          # 控制器，包含具体的业务逻辑
│   └── uploadImageController.js # 用户相关的控制器
├── models/               # Mongoose 数据模型
│   └── uploadImage.js           # 用户模型
├── routes/               # 路由定义
│   └── routes.js     # 用户相关路由
├── uploads/               # 上传图片目录
├── app.js                # Koa 应用的入口文件
└── package.json          # 项目配置文件

安装npm包

npm install koa koa-router koa-bodyparser mongoose koa-static koa-multer

代码示例

app.js

const Koa = require('koa');
const bodyParser = require('koa-bodyparser');
const connectDB = require('./config/database');
const koaStatic = require('koa-static');
const userRoutes = require('./routes/routes');//引入路由
const path = require('path');

// 连接到数据库
connectDB();

const app = new Koa();

// 使用 bodyParser 解析请求体
app.use(bodyParser());

// 静态文件服务
app.use(koaStatic(path.join(__dirname, 'uploads'))); // 提供上传文件的静态资源服务

// 加载 user 路由
app.use(userRoutes.routes()); // 使用 userRoutes 路由
app.use(userRoutes.allowedMethods()); // 使用 allowedMethods

// 启动服务器
app.listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

config/database.js

// config/database.js
const mongoose = require('mongoose');

const connectDB = async () => {
  try {
    await mongoose.connect('mongodb://localhost:端口号/数据库名称');//例如:mongodb://localhost:27017/xxxx
    console.log('MongoDB connected');
  } catch (err) {
    console.error(err);
  }
};

module.exports = connectDB;

models/uploadImage.js

const mongoose = require('mongoose');
// 创建图片存储的 Schema 和 Model
const ImgSchema = new mongoose.Schema({
    filename: String,//文件名称
    path: String,//文件目录
    url: String, // 用来存储图片的URL
    createdAt: { type: Date, default: Date.now },//创建时间
  });
  
  const photoImg = mongoose.model('photoImg', ImgSchema);

  module.exports = photoImg;

controllers/uploadImageController.js

const multer = require('@koa/multer');
const path = require('path');
const photoImg = require('../models/uploadImage');  // 引用正确的模型

// 配置上传目录，确保 uploads 目录存在
const upload = multer({
  dest: path.join(__dirname, '/../uploads/'),  // 上传的文件存储路径
  limits: { fileSize: 5 * 1024 * 1024 }, // 限制文件大小为 5MB
});

// 上传图片接口的逻辑
const uploadImage = async (ctx) => {

    const { file } = ctx.request;  // 获取上传的文件
    console.log('File:', file);  // 打印文件信息

    if (!file) {
      ctx.status = 400;
      ctx.body = { error: 'No file uploaded' };  // 如果没有文件上传
      return;
    }
  
    const imageUrl = `http://localhost:3000/uploads/${file.filename}`; // 图片的 URL 地址
  
    // 保存文件信息到数据库
    const newPhoto = new photoImg({
      filename: file.originalname,
      path: file.path,
      url: imageUrl,
    });
  
    try {
      await newPhoto.save();
      ctx.status = 201;
      ctx.body = { success: true, url: imageUrl }; // 返回图片的 URL
    } catch (err) {
      ctx.status = 500;
      ctx.body = { error: 'Failed to save image', details: err.message };
    }
  };
  
  

// 获取所有图片信息
const getPhotos = async (ctx) => {
  try {
    const photos = await photoImg.find(); // 查询所有图片
    ctx.body = { success: true, data: photos };
  } catch (err) {
    ctx.status = 500;
    ctx.body = { error: 'Failed to fetch photos' };
  }
};

// 获取指定 ID 的图片信息
const getPhotoById = async (ctx) => {
  const { id } = ctx.params;
  try {
    const photo = await photoImg.findById(id); // 根据 ID 查找图片
    if (!photo) {
      ctx.status = 404;
      ctx.body = { success: false, message: 'Photo not found' };
    } else {
      ctx.status = 200;
      ctx.body = { success: true, data: photo };
    }
  } catch (err) {
    ctx.status = 500;
    ctx.body = { success: false, message: 'Network error' };
  }
};

module.exports = {
  uploadImage,
  getPhotos,
  getPhotoById,
  upload,  // 导出上传中间件
};

routes/routes.js

// routes/routes.js
const Router = require('koa-router');

const  imgController = require('../controllers/uploadImageController')

const router = new Router();

// 图片上传接口

// 定义 Post 请求 - 获取用户信息
router.post('/upload', imgController.upload.single('image'), imgController.uploadImage);

// 定义 GET 请求 - 获取所有图片
router.get('/photos', imgController.getPhotos);

// 定义 GET 请求 -  获取指定 ID 的图片
router.get('/photos/:id', imgController.getPhotoById);

module.exports = router;

测试

发起postman请求，参数为image，格式类型为file

本地上传file打印结果：

请求前uploads目录为空

请求成功后uploads添加成功数据


查看数据库path，url目录保存图片，是否访问成功