Node.js在挂载共享驱动器上重复重命名文件失败问题求助

这个问题的核心是Linux挂载Windows SMB共享目录时的文件系统元数据缓存不一致。当通过Windows端修改文件名后，Linux内核的文件系统缓存没有及时同步更新，导致Node.js（依赖内核提供的文件信息）误判文件状态：

• 认为源文件和目标文件是同一个（inode相同），所以rename无动作、fs-extra.move报错"Source and destination must not be the same"
• 缓存的文件状态异常，导致copyFile出现系统错误-116（对应Linux的ESTALE，即文件句柄失效/元数据过期）

1. 强制刷新文件系统缓存 #

在执行Node.js重命名操作前，先同步共享目录的元数据，避免缓存干扰：

• 执行系统sync命令，强制刷新所有缓存：

  const { execSync } = require('child_process');
  // 在重命名前执行
  execSync('sync');
  

• 或者针对目标目录刷新（需要root权限）：

  execSync('echo 3 > /proc/sys/vm/drop_caches');
  

2. 修正Copy+Unlink的代码逻辑 #

你之前的copyFile代码错误混用了Promise和回调函数，导致异步流程混乱，修正后的代码：

const fs = require('fs').promises;
const { constants } = require('fs');

const rename = async (path) => {
  const newPath = `${path}_processed`;
  try {
    // 先验证源文件存在且可访问
    await fs.access(path, constants.F_OK | constants.R_OK);
    // 复制文件（Promise版本无需回调）
    await fs.copyFile(path, newPath);
    // 删除源文件
    await fs.unlink(path);
    console.log(`-----removed: ${path}`);
    console.log(`-----moved: ${path} -> ${newPath}`);
  } catch (err) {
    console.error('操作失败:', err);
  }
};

3. 修改SMB挂载参数，减少缓存 #

重新挂载Windows共享时，添加缓存相关参数，避免元数据不同步：

mount -t cifs //your-windows-share/path /var/lib/sitecontents \
  -o username=your-user,password=your-pass,cache=none,nounix,noserverino

• cache=none：禁用客户端缓存
• nounix：不映射Unix权限和元数据，避免和Windows文件系统冲突
• noserverino：不使用服务器返回的inode，强制Linux生成本地inode，减少inode冲突

4. 升级Node.js版本 #

Node.js 12.19.0是较老的版本，存在一些文件系统相关的已知bug。升级到Node.js 14.x或16.x LTS版本，可能直接解决该兼容性问题。

5. 绕过缓存的临时文件方案 #

如果上述方法无效，可以通过临时文件中转，规避缓存误判：

const renameWithTemp = async (path) => {
  const tempPath = `${path}.tmp`;
  const newPath = `${path}_processed`;
  try {
    // 先重命名为临时文件
    await fs.rename(path, tempPath);
    // 再重命名为目标文件
    await fs.rename(tempPath, newPath);
    console.log(`重命名成功: ${path} -> ${newPath}`);
  } catch (err) {
    console.error('临时文件方案失败:', err);
  }
};

内容的提问来源于stack exchange，提问作者Jamie Nicholls