Android Studio错误处理及指定IllegalStateException问题排查求助

嘿，咱们一步步来解决你的问题——先说说Android Studio里遇到错误的通用处理思路，再深入拆解你碰到的那个IllegalStateException异常。

一、Android Studio错误通用处理流程 #

当你在IDE里遇到错误时，不用慌，按这个步骤排查效率更高：

• 先明确错误类型：先区分是编译报错、运行时崩溃还是IDE本身的异常。编译错误看底部Build窗口的红色提示，运行时问题重点看Logcat的堆栈跟踪，IDE自身异常去Event Log里找线索。
• 抓核心错误信息：别被一堆日志淹没，先看最顶部的错误提示（比如编译错误里的"找不到符号"，运行时异常的Caused by行），这通常就是问题根源所在。
• 清理重建+缓存重置：很多奇怪问题都是缓存闹的，先点Build > Clean Project再Rebuild Project；如果还不行，就选File > Invalidate Caches... > Invalidate and Restart，这招能解决不少IDE"抽风"的问题。
• 检查依赖和SDK配置：比如依赖冲突会提示Conflict with dependency...，可以用终端运行./gradlew dependencies查看完整依赖树；另外确认compileSdkVersion、targetSdkVersion和你下载的SDK版本一致。
• 精准搜索关键词：把异常的核心部分（比如java.lang.IllegalStateException: Can't start find usages）拿去搜索，大部分常见问题都有现成的解决方案。

二、解决java.lang.IllegalStateException: Can't start find usages from under write action #

1. 定位问题根源 #

这个异常的本质是：你在一个「写操作上下文」里触发了「查找引用（Find Usages）」的操作。Android Studio基于IntelliJ平台，它有严格的线程和操作上下文规则：

• 「写操作（Write Action）」是用来修改IDE内部状态的（比如修改文件、变更项目结构），在这个上下文里不允许执行耗时的读操作（比如Find Usages，因为它会阻塞写操作，还可能引发状态不一致）。

你可以从这几个方向排查：

• 自定义插件/代码逻辑：如果你在开发IDE插件，或者写了自定义的代码生成/修改工具，检查是否在WriteCommandAction的run方法里调用了Find Usages相关的API（比如UsageSearcher、FindUsagesManager的方法）。
• 第三方插件冲突：如果不是你自己写的代码，大概率是某个第三方插件在执行写操作时触发了Find Usages——比如一些自动格式化、代码补全或者批量修改的插件。
• 自定义快捷键/宏：有没有设置过自定义快捷键，不小心把写操作和Find Usages绑定到了一起，导致触发时机错误？

2. 具体解决方案 #

• 把Find Usages移到写操作之外：如果是你自己的代码，用Application.invokeLater()把查找操作推迟到写操作完成后执行，示例代码：

  WriteCommandAction.runWriteCommandAction(project, () -> {
      // 这里是你的写操作逻辑，比如修改文件内容
      modifyFileContent();
      
      // 不要在这里直接调用Find Usages，用invokeLater延迟执行
      ApplicationManager.getApplication().invokeLater(() -> {
          // 在这里执行Find Usages操作
          performFindUsages();
      });
  });
  

• 排查第三方插件：先禁用最近安装的插件，重启IDE试试。如果找到是某个插件的问题，要么更新插件到最新版，要么换个替代插件。
• 重置IDE缓存：有时候IDE内部状态混乱也会触发这个异常，执行File > Invalidate Caches... > Invalidate and Restart，清理后再测试。
• 检查快捷键设置：去File > Settings > Keymap里搜索Find Usages，看看有没有和写操作相关的快捷键冲突，调整一下即可。

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