Error: ENOENT: no such file or directory, open 'uploads/avatar-1735558854061-489371420.png'

### 解析 ENOENT 错误并解决头像路径问题

当遇到 `ENOENT` 错误，表示操作系统无法找到指定的文件或目录。对于上传图片特别是设置博客系统的头像时，如果出现此类错误通常是因为路径配置不当。

#### 配置头像路径

为了确保头像能够正常显示，在 NexT 主题中应按照如下方式配置：

# 在主题 _config.yml 中编辑 avatar 的配置
avatar: /images/avatar.png  # 修改为正确的相对路径
url: /images/avatar.png     # 如果使用自定义链接，则填写绝对 URL
rounded: true               # 圆形展示开关
rotated: false              # 是否跟随鼠标旋转

上述配置项中的 `/images/avatar.png` 是相对于站点根目录而言的路径[^2]。

#### 处理文件上传至特定位置

假设希望将用户上传的文件保存到 `uploads` 文件夹内，并且该文件夹位于项目根目录下。此时可以通过 Express 实现简单的文件接收功能来处理 POST 请求中的文件数据流。

const express = require('express');
const multer  = require('multer'); // Multer is a node.js middleware for handling multipart/form-data.
const path    = require('path');

// 设置存储引擎
var storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, 'public/uploads/') // 存储目标文件夹
  },
  filename: function (req, file, cb) {
    cb(null, Date.now() + path.extname(file.originalname)) // 使用时间戳作为新文件名加上原扩展名
  }
});

let upload = multer({storage: storage}).single('file');

app.post('/upload', function(req, res){
  upload(req, res, function(err){
      if(!err){
          return res.send("File uploaded successfully");
      }else{
          console.error(err);
          return res.status(500).send("Error uploading file.");
      }
  });
});

这段代码实现了通过 HTTP POST 方法向服务器提交单个文件的功能，并将其存入名为 `public/uploads/` 的子目录中[^1]。

#### 创建缺失的目录结构

为了避免因缺少必要的父级目录而导致写入失败的情况发生，可以在应用启动前检查并创建这些必需存在的文件夹：

if (!fs.existsSync('./public')) fs.mkdirSync('./public');
if (!fs.existsSync('./public/uploads')) fs.mkdirSync('./public/uploads');

以上命令会检测当前工作空间是否存在对应的公共资源文件夹以及用于存放上载资料的目标容器；一旦发现不存在就会立即建立它们。