解读

在国内前端团队里，Grunt 通常被当成“构建中枢”而非“版本管理器”。面试官问“同步失败如何回滚”，并不是想听你讲 git revert，而是考察两点：

1. 你是否把 Grunt 的中间产物与源码隔离；
2. 你是否在任务链里内置了原子化与回滚钩子，一旦同步（copy、ftp、s3、rsync 等）异常，能秒级恢复现场，避免页面 404、缓存破裂或线上白屏。
   因此，回答要围绕“构建层回滚”展开，而不是“版本控制层回滚”。

知识点

• grunt-contrib-copy / grunt-sync / grunt-ftp-push：国内常用的同步插件，均提供fail 事件与process 选项；
• grunt.file：底层 API，支持递归拷贝、MD5 比对、强制删除；
• grunt.event：任务级事件总线，可监听warn、error、exit；
• grunt.task.current：在任务体内拿到当前任务名，用于动态生成备份目录；
• grunt.fail：官方异常模块，可阻止后续任务并触发回滚钩子；
• 临时目录规范：国内大厂普遍要求**“.grunt-tmp/yyyyMMddHHmmss”，并与 Jenkins / GitLab Runner 的BUILD_ID挂钩，保证多实例并发**时互不影响；
• 原子发布：先同步到版本化子目录，再切换软链，失败时回滚软链即可，杜绝“半同步”状态。

答案

线上最稳的方案是“双目录 + 软链 + Grunt 钩子”，步骤如下：

1. 在 Gruntfile 里定义全局备份路径

   var path = require('path');
   var backupDir = '.grunt-tmp/backup-' + grunt.template.today('yyyymmddHHMMss');
   

2. 在正式同步前，用 grunt-contrib-copy 把线上目录整站快照到 backupDir，并记录当前软链指向

   grunt.registerTask('pre-sync', function() {
     var target = grunt.config('sync.target.path');   // /data/web/xxx
     var current = fs.readlinkSync(target);           // 记录 current 版本
     grunt.config.set('_backup.current', current);
     grunt.file.copy(target, backupDir, { preserveTimestamps: true });
   });
   

3. 使用grunt-sync 做增量同步，并监听 fail 事件

   grunt.config.set('sync.dist', {
     files: [{ cwd: 'dist', src: '**', dest: '/data/web/releases/<%= pkg.version %>' }],
     fail: function(err) {
       grunt.event.emit('sync:error', err);
     }
   });
   

4. 在任务链里注册回滚钩子

   grunt.event.on('sync:error', function() {
     var current = grunt.config('_backup.current');
     // 1. 删除失败的 release 目录
     grunt.file.delete('/data/web/releases/<%= pkg.version %>');
     // 2. 恢复软链
     fs.unlinkSync('/data/web/xxx');
     fs.symlinkSync(current, '/data/web/xxx');
     grunt.log.error('同步失败，已回滚至 ' + current);
   });
   

5. 最后把任务串起来，任何一步异常都会触发回滚

   grunt.registerTask('deploy', ['pre-sync', 'sync', 'update-symlink']);
   

该方案不依赖 git，不回滚源码，只回滚线上产物，符合国内“编译后发布”的规范；且备份目录按时间戳命名，Jenkins 并行构建也不会踩坑。

拓展思考

• 如果同步目标是阿里云 OSS 或腾讯云 COS，插件本身没有本地目录概念，此时应把“回滚”转成“版本回退”：先给每个对象加x-oss-version-id 头部，同步失败时调用deleteMultipleObjects 删除本次上传的 versionId，再恢复旧 versionId；
• 对于微前端场景，子应用独立构建，主应用通过nginx ssi 聚合。可在 Grunt 里维护一份manifest.json，回滚时只需把 manifest 里的entry url 指向上一个contenthash 即可，实现秒级热回滚；
• 当项目达到千台容器规模，建议把 Grunt 仅当本地构建器，回滚逻辑下沉到Kubernetes 的 rollout undo 或阿里 MSE 灰度平台，但 Grunt 仍需保证每次构建产出 deterministic（相同的 git commit 必须打出相同的 dist-hash），否则回滚会触发全量重新编译，失去意义。