native 约束与兼容性

Solon AOT / Native 对代码有一些硬约束和软建议。硬约束违反会在 AOT 或 native 构建阶段直接报错；软建议是为了让打包更顺利。写代码前先过一遍本文。

1、代理组件四约束（硬约束）

Solon 中被代理的 bean（如 @Component 且需要 AOP 增强的类），AOT 阶段会为其生成静态代理类。以下四类不能作为代理组件，违反会在 AOT 阶段直接抛错：

应对：

• 这类 bean 如果不需要 AOP 增强，可以不加代理（如不配置拦截、不标记需要增强的注解）；
• 需要增强则必须改造成 public 非 final 非泛型非抽象类。

2、启动副作用约束（硬约束）

AOT 阶段会真实启动一次应用来收集容器信息：

• 主类 main 里的初始化逻辑会执行（发消息、写库、定时任务、预热缓存等）；
• 启动依赖的外部服务（DB、Redis、配置中心）在打包机上必须可用；
• 启动抛异常会中断 maven 打包（SolonAotProcessor 会把异常向上抛）。

应对：把启动副作用代码放进条件判断：

public class DemoApp {
    public static void main(String[] args) {
        Solon.start(DemoApp.class, args, app -> {
            // 打包机上的 AOT 处理阶段，跳过有副作用的初始化
            if (NativeDetector.isNotAotRuntime()) {
                initSendMessage();
                initWarmCache();
            }
        });
    }
}

3、环境约束（硬约束）

4、代码编写建议（软建议）

5、运行时环境探测（NativeDetector）

内核提供 org.noear.solon.core.runtime.NativeDetector，用于区分三种运行环境：

常见写法：

• 普通运行时与 native 运行时行为一致 → 用 isNotAotRuntime()；
• 仅 native 才有的优化 → 用 inNativeImage()。