更新React应用服务时Git报index.lock存在部署失败如何修复？

致命错误：无法创建 '/home/site/repository/.git/index.lock'：文件已存在。

当前仓库中似乎有另一个Git进程正在运行，例如由git commit命令唤起的编辑器。请确保所有相关进程都已终止后重试。如果重试仍然失败，可能是此前该仓库中的某个Git进程异常崩溃：请手动删除该文件以继续操作。

/usr/bin/git checkout master --force

该错误由Git操作异常中断导致的锁文件遗留触发，Git执行写操作时会自动创建index.lock避免并发冲突，操作正常结束后会自动删除，若进程意外崩溃就会残留该文件，阻塞后续所有Git写操作。可按以下步骤修复：

步骤1：删除遗留的锁文件 #

根据你的部署环境选择对应操作：

• 若使用云厂商托管应用服务（如Azure App Service、腾讯云Web应用托管等）：进入应用服务提供的在线SSH/Kudu控制台，直接执行删除命令：

  rm /home/site/repository/.git/index.lock
  

• 若使用自行管理的VPS/物理服务器部署：登录服务器后进入你的应用部署的Git仓库目录，执行删除命令：

  rm .git/index.lock
  

步骤2：验证仓库状态 #

删除锁文件后执行以下命令验证Git仓库状态正常：

git status

若命令无报错输出，说明锁文件问题已解决。

步骤3：重试部署 #

直接重新触发你的部署流程即可，无论是CI/CD自动部署、Git推送部署还是手动上传部署都可以正常执行。

异常场景处理 #

如果删除锁文件后仍提示Git相关错误，可执行以下命令重置仓库（注意：会清除仓库目录内所有未提交的本地改动，如有自定义修改请先备份）：

git reset --hard HEAD
git checkout master --force
git pull origin master --force

内容的提问来源于stack exchange，提问作者Alejandro Peña