Capistrano部署失败：mv无法移动被识别为目录的current符号链接

你这是踩了MacBSD工具和LinuxGNU工具行为差异的坑——Mac自带的mv命令和Linux上的mv处理符号链接的逻辑不一样，导致部署到符号链接步骤时出错了。

问题分析 #

从你的错误日志能明确看到关键节点：

1. 第一步成功创建了指向新版本的符号链接：ln -s /Users/jean/www/rails_app/app/releases/20180120135811 /Users/jean/www/rails_app/app/releases/current
2. 第二步执行mv命令时触发报错：mv: rename ... to ...: Is a directory

核心原因是：Mac的BSD版本mv会把指向目录的符号链接当成实际目录对待，当你尝试将这个符号链接移动到已经存在current目录的位置时，它会直接拒绝执行（而Linux的GNU版本mv会直接移动符号链接本身，不会有这个限制）。

解决方案 #

这里有几个实用的解决办法，你可以根据自己的部署场景选择：

方法1：给Capistrano的mv命令添加-r参数

直接在deploy.rb里配置，让Capistrano执行mv时带上递归参数，适配Mac的BSD工具特性：

# 仅在Mac环境下调整mv命令参数
if RUBY_PLATFORM.downcase.include?('darwin')
  set :symlink_mv_flags, '-r'
end

-r参数会让BSDmv递归处理符号链接指向的内容，绕过目录判断的报错逻辑。

方法2：提前清理旧的current目录/符号链接

如果你的部署目标路径下已经存在一个真实的current目录（而非符号链接），可以在symlink步骤前先强制清理掉它：

# 在symlink步骤前执行清理任务
before 'deploy:symlink:release', 'deploy:remove_old_current'

namespace :deploy do
  desc '强制删除旧的current目录/符号链接'
  task :remove_old_current do
    on roles(:app) do
      execute :rm, '-rf', "#{deploy_to}/current"
    end
  end
end

清理完成后，新的符号链接移动时就不会遇到路径冲突了。

方法3：直接在目标位置创建符号链接（跳过移动步骤）

干脆绕开mv命令，直接在应用根目录创建/覆盖符号链接，这也是更简洁高效的方式：

namespace :deploy do
  task :symlink_release do
    on roles(:app) do
      # 直接创建指向新版本的符号链接，-f参数强制覆盖旧链接
      execute :ln, '-sf', release_path, "#{deploy_to}/current"
    end
  end
end

# 替换Capistrano默认的symlink:release任务
Rake::Task['deploy:symlink:release'].clear_actions
Rake::Task['deploy:symlink:release'].enhance do
  invoke 'deploy:symlink_release'
end

这种方法跳过了先在releases目录创建current再移动的步骤，从根源避免了mv命令带来的兼容性问题。

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