IntelliJ IDEA SSH远程运行应用报Needs read action错误如何解决？

问题根因 #

你遇到的Error running 'application-ssh': Failed to prepare target. Needs read action错误是IntelliJ IDEA 2021.2~2021.3版本SSH远程运行功能的已知缺陷：批量上传Gradle依赖缓存到远程服务器时，IDEA内部文件读取锁被其他后台任务占用，导致文件传输任务中断。SSH连接本身没有问题，rsync开关不影响该错误触发。

解决方案 #

• 方案1（永久修复）：升级IntelliJ IDEA到2022.1及以上稳定版本，官方已在该版本修复该文件锁冲突问题
• 方案2（无需升级的临时解决方案）：
  1. 打开对应SSH远程运行的配置页，找到上传路径规则设置
  2. 删除自动生成的全局.gradle/caches批量上传规则，仅保留项目编译产物的上传路径（即你日志中出现的workspace/xxx/xxx-xxx-xxx/build相关路径）
  3. 手动将本地.gradle/caches目录中项目所需的依赖包上传到远程服务器对应目录，后续运行无需重复批量传输依赖，即可避开锁冲突触发条件
• 方案3（临时兼容方案）：执行远程运行前，关闭所有IDEA后台扫描类任务（包括实时代码检查、自动编译、第三方代码扫描插件等），避免其他任务占用文件读取锁

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