使用Cloudinary修复Multer中的“无法读取未定义的属性（读取‘路径’）”

了解并解决“无法读取未定义的属性”错误

该解决方案演示了使用 Node.js 与 Express、Multer 和 Cloudinary 的模块化后端方法。我们实施文件上传和错误处理来解决该问题。

// cloudinaryConfig.js
import { v2 as cloudinary } from 'cloudinary';
import dotenv from 'dotenv';
dotenv.config();
const connectCloudinary = async () => {
  cloudinary.config({
    cloud_name: process.env.CLOUDINARY_NAME,
    api_key: process.env.CLOUDINARY_API_KEY,
    api_secret: process.env.CLOUDINARY_SECRET_KEY,
  });
};
export default connectCloudinary;
// Ensures Cloudinary setup is initialized before uploads

用于文件上传的模块化 Multer 配置

在这里，我们配置 Multer 来安全地处理文件上传，并在使用 Cloudinary 处理之前将它们存储在本地。

// multerConfig.js
import multer from 'multer';
import path from 'path';
const storage = multer.diskStorage({
  destination: function (req, file, callback) {
    callback(null, path.resolve('./uploads'));
  },
  filename: function (req, file, callback) {
    callback(null, new Date().toISOString().replace(/:/g, '-') + '-' + file.originalname);
  },
});
const fileFilter = (req, file, callback) => {
  if (file.mimetype.startsWith('image/')) {
    callback(null, true);
  } else {
    callback(new Error('Only image files are allowed!'), false);
  }
};
const upload = multer({ storage, fileFilter });
export default upload;
// Ensures uploaded files meet specific conditions

处理文件上传的 API 路由

该脚本设置用于处理医生创建的 API 路径，包括表单验证和 Cloudinary 文件上传。

// adminRoute.js
import express from 'express';
import { addDoctor } from '../controllers/adminController.js';
import upload from '../middlewares/multerConfig.js';
const adminRouter = express.Router();
// Endpoint for adding doctors
adminRouter.post('/add-doctor', upload.single('image'), addDoctor);
export default adminRouter;
// Routes the request to the appropriate controller function

处理请求并与 Cloudinary 交互的控制器函数

此脚本说明了用于验证输入、散列密码以及将图像上传到 Cloudinary 的服务器端逻辑。

// adminController.js
import bcrypt from 'bcrypt';
import { v2 as cloudinary } from 'cloudinary';
import doctorModel from '../models/doctorModel.js';
const addDoctor = async (req, res) => {
  try {
    const { name, email, password, speciality, degree, experience, about, fees, address } = req.body;
    const imageFile = req.file;
    if (!imageFile) throw new Error('Image file is required');
    const hashedPassword = await bcrypt.hash(password, 10);
    const imageUpload = await cloudinary.uploader.upload(imageFile.path, { resource_type: 'image' });
    const doctorData = { name, email, password: hashedPassword, speciality, degree,
      experience, about, fees, address: JSON.parse(address), image: imageUpload.secure_url, date: Date.now() };
    const newDoctor = new doctorModel(doctorData);
    await newDoctor.save();
    res.json({ success: true, message: 'Doctor added successfully' });
  } catch (error) {
    res.json({ success: false, message: error.message });
  }
};
export { addDoctor };
// Manages API logic and ensures proper data validation

测试和验证

此单元测试可确保端点在多种场景下正常运行。

// adminRoute.test.js
import request from 'supertest';
import app from '../app.js';
describe('Add Doctor API', () => {
  it('should successfully add a doctor', async () => {
    const response = await request(app)
      .post('/admin/add-doctor')
      .field('name', 'Dr. Smith')
      .field('email', 'drsmith@example.com')
      .field('password', 'strongpassword123')
      .attach('image', './test-assets/doctor.jpg');
    expect(response.body.success).toBe(true);
  });
});
// Validates success scenarios and API response structure

有关 Node.js 中文件上传的常见问题

1. 是什么原因导致 Multer 中“无法读取未定义的属性”？
2. 当客户端请求中的密钥与中指定的密钥不匹配时，通常会发生这种情况 upload.single。确保它们对齐。
3. 如何在 Multer 中根据类型过滤文件？
4. 使用 fileFilter Multer 中的选项。例如，检查文件的 mimetype file.mimetype.startsWith('image/')。
5. 如何确保使用 Cloudinary 安全上传？
6. 通过添加选项来使用安全转换，例如在上传期间调整大小 cloudinary.uploader.upload。
7. 存储敏感 API 密钥的最佳方式是什么？
8. 将 API 密钥存储在 .env 文件并加载它们 dotenv.config。
9. 为什么我上传的文件没有显示在 Cloudinary 中？
10. 检查文件路径是否在 req.file.path 被正确传递到 cloudinary.uploader.upload 并且该文件存在于本地。
11. 如何防止覆盖文件名？
12. 使用自定义文件名函数 multer.diskStorage 将唯一的时间戳或 UUID 附加到每个文件名。
13. 我可以使用 Multer 处理多个文件上传吗？
14. 是的，使用 upload.array 或者 upload.fields 根据您对多个文件的要求。
15. 有什么作用 path.resolve 在穆尔特?
16. 它确保目标目录正确解析为绝对路径，避免存储错误。
17. 如何记录上传详细信息？
18. 使用类似的库 winston 或者 morgan 记录文件名、大小和时间戳等详细信息。
19. 上传到 Cloudinary 之前是否可以调整图像大小？
20. 是的，直接应用转换 cloudinary.uploader.upload，例如宽度和高度的调整。

关于解决文件上传错误的最终想法

遇到“无法读取未定义的属性”之类的错误可能会令人沮丧，但通过系统化的方法，这些挑战变得可以管理。使用类似的工具 穆尔特 用于文件处理和 云数 for storage 为 Web 开发创建了一个强大的、可扩展的解决方案。

实际调试，例如检查关键不匹配和正确配置中间件，确保开发顺利进行。这些技术与错误记录和验证相结合，可以节省时间和精力。通过坚持和正确的方法，开发人员可以创建无缝的文件上传功能。 🚀