Windows下Node.js fs.lstat与fs.readlink无法识别SMB共享符号链接

核心原因 #

Windows资源管理器能识别Unraid共享里的符号链接，是因为SMB客户端默认做了透明解析——把符号链接直接当成目标文件/文件夹展示，不会暴露链接本身的元数据。但Node.js的fs模块和WSL是直接调用底层SMB文件系统接口，默认没有开启符号链接的暴露选项，所以无法识别。

具体来说：

• Windows上的Node.js：SMB挂载时，系统驱动自动跳转符号链接，fs.lstat()拿到的是目标文件的信息，而非链接本身，自然返回isSymbolicLink() = false。
• WSL环境：WSL的SMB挂载实现默认不处理Unraid的类Unix符号链接，跨系统的链接格式不兼容，导致WSL本身和其中的Node.js都无法识别。

解决办法 #

1. Windows端重新挂载SMB共享（开启符号链接支持） #

不要用资源管理器映射驱动器，改用命令行挂载并添加/symlink参数：

net use Z: \\Unraid-IP\你的共享名 /persistent:yes /symlink

如果需要全局生效，可修改注册表（谨慎操作，有安全风险）：

• 打开注册表编辑器，定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters
• 添加DWORD值EnableSymlinks，设置为1
• 重启电脑后，Node.js的fs.lstat()和readlink()就能正常识别符号链接。

2. WSL环境下挂载SMB共享 #

挂载时添加symlinks选项，让CIFS驱动解析Unraid的符号链接：

sudo mkdir /mnt/unraid-share
sudo mount -t cifs //Unraid-IP/你的共享名 /mnt/unraid-share -o username=你的用户名,password=你的密码,vers=3.0,symlinks

如果仍不生效，可尝试加上mfsymlinks选项（模拟符号链接）：

sudo mount -t cifs //Unraid-IP/你的共享名 /mnt/unraid-share -o username=你的用户名,password=你的密码,vers=3.0,symlinks,mfsymlinks

3. Node.js代码层面兼容（无法修改挂载配置时） #

如果不能调整挂载设置，可以通过调用系统命令解析输出来判断符号链接：
Windows端示例代码：

const { execSync } = require('child_process');

function checkIsSymlink(path) {
  try {
    const dirOutput = execSync(`dir "${path}" /AL`, { encoding: 'utf8' });
    return dirOutput.includes('<SYMLINK>') || dirOutput.includes('<SYMLINKD>');
  } catch (err) {
    return false;
  }
}

WSL端可改用ls -l命令解析输出，判断行首是否为l。

注意事项 #

• 修改注册表或挂载选项存在安全风险，符号链接可能被用于绕过权限控制，仅在可信网络环境中使用。
• 确保Unraid的SMB服务已开启符号链接支持：在Unraid的共享设置中勾选“允许符号链接”选项。

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