编译器配置与限制指南

编译器设置与约束

1、 默认情况下，编译器处于关闭状态。您可通过两种方式启用它：一是借助此前介绍的解析器配置流程；二是在将SpEL集成到其他组件时，通过设置系统属性来开启。本节将详细说明这两种启用方式及其适用场景。

2、 编译器支持三种运行模式，对应 `org.springframework.expression.spel.SpelCompilerMode` 枚举中的三个枚举值，分别为：`OFF`（禁用编译）、`MIXED`（混合模式，动态与编译执行并存）以及 `IMMEDIATE`（立即编译，表达式首次执行后即编译）。

3、 IMMEDIATE模式的存在，是为了规避MIXED模式可能引发的风险。在MIXED模式下，若编译后的表达式执行至中途发生异常，其前置副作用操作可能已实际改变系统状态。此时若自动降级为解释模式并静默重试，将导致部分逻辑被重复执行，进而引发状态不一致或不可预期的行为。因此，IMMEDIATE模式强制要求表达式必须完整、原子地执行，避免因部分成功而带来的状态污染与重复执行问题，从而保障操作的确定性与安全性。

4、 选定模式后，需通过SpelParserConfiguration类对表达式解析器进行配置，具体实现方式如以下示例所示。

5、 配置SpEL编译器的另一种方式适用于其嵌入于其他组件且无法通过常规配置对象进行设置的场景。此时，可通过系统属性实现配置：将系统属性 `spring.expression.compiler.mode` 的值设为 `SpelCompilerMode` 枚举中的某一项，即 `off`（禁用编译）、`immediate`（立即编译）或 `mixed`（混合模式）。该方式无需依赖特定配置类或Bean定义，具备良好的环境适配性，尤其适合在容器化部署、微服务架构或第三方框架集成等受限配置条件下使用，能灵活控制表达式编译行为，兼顾性能与调试需求。

6、 自Spring Framework 4.1起，基础编译框架已初步构建完成。但该框架目前尚未实现对各类表达式的编译支持，初期主要聚焦于性能敏感场景中高频使用的表达式类型。现阶段，以下几类表达式仍无法被编译处理。