使用方式

如果你只是为了能让插件正常使用，只看本章节即可。

第一步：下载

直接下载打包好的jar ：Release：apipost-idea-plugin-patch-agent-xx.jar。

第二步：配置

找到 IDEA 配置目录下的 JVM 参数文件，一般文件后缀为 .vmoptions ，可以全局搜索。有的人可能会有多个此文件，需要确定idea用的是哪个，如果不确定，那就都改一下吧：

• Windows：%APPDATA%\JetBrains\IntelliJIdea2025.x\idea64.exe.vmoptions
• macOS：~/Library/Application Support/JetBrains/IntelliJIdea2025.x/idea.vmoptions
• Linux：~/.config/JetBrains/IntelliJIdea2025.x/idea64.vmoptions

在文件末尾添加一行，注意后面要替换成你上一步下载的jar的实际地址，配置错了idea会无法启动：

-javaagent:C:/path/to/apipost-idea-plugin-patch-agent-1.1.jar

第三步：重启idea

重启 IDEA 后生效。日志中出现以下输出说明 Agent 加载成功：

[ReadActionPatch] Agent loaded
[ReadActionPatch] patched: cn/apipost/restful/debug/RestServiceDetail#setApiService
[ReadActionPatch] patched: cn/apipost/restful/debug/CustomEditor#createDocument
...

apipost-idea-plugin-patch-agent

一个 Java Agent，用于在运行时自动修复旧版 Apipost IDEA 插件中大量 Read access is allowed from inside read-action only 异常。

背景

Apipost IDEA 官方插件（v1.0.23）在多处直接在 EDT（Event Dispatch Thread）上访问 PSI/模型 API，未包裹在 ReadAction 中，导致 IDEA 2025.x 频繁抛出：

com.intellij.openapi.diagnostic.RuntimeExceptionWithAttachments:
Read access is allowed from inside read-action only

在新版IDEA2026.1直接无法使用。 由于插件官方久无人维护，且未提供源码，无法从源码修复，因此采用 Java Agent 在类加载时动态织入 ReadAction 包装，无需修改插件 JAR 本身。

原理

IDEA 启动
   │
   ▼
JVM 加载 Agent（-javaagent 参数）
   │
   ▼
ReadActionTransformer.transform() 拦截目标类加载
   │
   ├─ 用 Javassist 将目标方法重命名为 _original_xxx
   │
   └─ 生成新方法体，通过 StaticHelper.runInReadAction()
      将原方法调用包裹在 ReadAction 中执行

项目结构

src/main/java/com/github/intfoo/agent/
├── AgentMain.java               # premain 入口，注册 Transformer
├── ReadActionTransformer.java   # ClassFileTransformer，拦截并织入目标方法
└── StaticHelper.java            # 运行时工具类，提供 ReadAction 包装执行

编译与打包

前置要求

• JDK 11+
• Maven 3.6+
• IntelliJ IDEA 本地安装（用于编译期依赖）

修改 pom.xml 中的 IDEA 路径

将以下依赖的 systemPath 改为本机 IDEA 安装路径：

<systemPath>D:/Program Files/JetBrains/IntelliJ IDEA 2025.3.1/lib/app.jar</systemPath>

打包

mvn clean package -DskipTests

产物为 target/apipost-idea-plugin-patch-agent-1.0.jar（带 original- 前缀的是备份，不用它）。

新增修复目标

在 ReadActionTransformer.java 的静态块中添加一行即可：

static {
    register("cn/apipost/restful/debug/RestServiceDetail",       "setApiService");
    register("cn/apipost/restful/debug/CustomEditor",            "createDocument");
    register("cn/apipost/restful/method/action/PropertiesHandler","findPsiFileInModule");
    // 新增：
    register("cn/apipost/restful/xxx/YourClass",                 "yourMethod");
}

如何找到需要修复的类

在 IDEA 日志（idea.log）中搜索：

Read access is allowed from inside read-action only

查看堆栈中 cn.apipost 开头的第一帧，即为需要注册的类和方法。

搜索类所在 JAR（PowerShell）

当编译报找不到某个 IDEA 内部类时，用以下脚本定位它在哪个 JAR：

$className = "com/intellij/openapi/util/UserDataHolder.class"
$ideaLib   = "D:\Program Files\JetBrains\IntelliJ IDEA 2025.3.1\lib"

Get-ChildItem "$ideaLib\*.jar" | ForEach-Object {
    $jar    = $_.FullName
    $result = & jar tf $jar 2>$null | Where-Object { $_ -eq $className }
    if ($result) { Write-Host $jar }
}

找到后在 pom.xml 中添加对应的 system 依赖。

已知限制

• StaticHelper.runInReadAction 内部使用反射调用原方法，有轻微性能开销。对于调用频繁的热点方法，可在 StaticHelper 中为其单独编写具名静态方法以避免反射。
• scope=system 的 IDEA 依赖与本机安装路径绑定，换机器需修改 pom.xml。
• 仅针对 Apipost IDEA 插件 v1.0.23 和 IDEA 202６.1 测试，其他版本未验证。

版本号管理建议

发布前用 Maven 统一更新版本号，不要手动改 pom.xml：

# 发布 1.1
mvn versions:set "-DnewVersion=1.1"   # 改版本号
mvn versions:commit                    # 删备份  git add pom.xml
git commit -m "release: v1.1.0"
git tag v1.1.0
git push origin main --tags