Docker容器中fs.isSymbolicLink()返回false问题排查

1. Docker挂载卷的默认行为导致软链接被替换 #

本地用ln -s -f创建的Geo软链接，在通过docker-compose挂载卷到容器时，Docker默认会解析软链接并挂载实际目标目录，而非保留软链接本身。这就是容器内ls -lah显示Geo是普通目录的核心原因——它已经被替换成软链接指向的/CodeBase/Geo/Admin/目录的实际内容。

2. Node.js fs.statSync的特性 #

你代码中检查的路径是./src/Geo/CityDivision/Field.jsx，这是一个实际文件，并非软链接。另外，fs.statSync()默认会自动跟随软链接，返回的是链接目标的文件状态，而非软链接自身的状态。就算直接检查./src/Geo目录（容器内已是实际目录），isSymbolicLink()也会返回false，因为它本身已不是软链接。

额外说明 #

如果需要在容器内保留软链接，可调整Docker挂载方式：

• 直接挂载软链接指向的实际目录，而非包含软链接的父目录；
• 或在docker-compose中配置bind: propagation: rshared（对应docker run的--mount type=bind,source=...,target=...,bind-propagation=rshared参数），但该方式要求主机与容器文件系统支持，且可能引发权限或一致性问题，需谨慎使用。

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