使用Shell脚本修改symlink目标时执行ln -sf命令不生效如何解决？

• 环境变量解析异常
  执行echo $PROJECT_PATH $PROJECT_VERSION $ACTIVE_PROJECT_SYMLINK确认三个变量的实际值是否符合预期，若变量未赋值、为空或拼接后的源路径不存在，ln -sf会静默执行失败或生成无效软链接，无明显报错。
• 目标路径带斜杠导致行为不符合预期
  如果$ACTIVE_PROJECT_SYMLINK指向的路径末尾带/，且该路径本身是已经存在的目录，ln -sf不会覆盖目录本身，而是会在该目录下新建一个和源文件名同名的软链接，而非修改你预期的上层软链接。
• 父目录权限不足
  当前执行命令的用户对$ACTIVE_PROJECT_SYMLINK所在的父目录没有写权限时，即使加了-f参数也无法覆盖原有软链接，部分shell环境下不会抛出明确的权限报错。可添加-v参数执行命令查看详细输出：ln -sfv $PROJECT_PATH$PROJECT_VERSION $ACTIVE_PROJECT_SYMLINK，若输出Permission denied即可确认是权限问题。
• 软链接被进程持有
  如果有运行中的进程正在占用该软链接的文件句柄，软链接的修改不会被运行中进程实时识别，需要重启对应进程后新的指向才会生效。
• 目标不是软链接
  若$ACTIVE_PROJECT_SYMLINK本身是普通文件、硬链接或目录而非软链接，ln -sf的行为会发生变化：如果是普通文件会直接删除原有文件再生成软链接，如果是目录会在目录内新建软链接。可执行ls -ld $ACTIVE_PROJECT_SYMLINK查看属性，第一列以l开头才是软链接。
• 相对路径计算错误
  如果$PROJECT_PATH$PROJECT_VERSION使用的是相对路径，需要注意软链接的相对路径是相对于软链接自身的存储目录，而非执行ln命令的工作目录，容易出现路径拼接错误导致指向不符合预期。

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