使用Roaster的AddEnumConstant方法触发IndexOutOfBoundsException失败

数据老陈

2026-8-12

问题分析与解决

异常原因

这个IndexOutOfBoundsException的核心原因是Java枚举常量的名称不允许包含点号（.），Roaster的内部解析逻辑因此触发了异常：

Roaster在处理枚举常量名称时，会默认遵循Java标识符规则，当传入带点号的"TEST."时，它会尝试将其当作嵌套类格式（比如Outer.Inner）拆分，但"TEST."拆分后最后一段是空字符串，导致访问索引0的元素时越界。
从Java语法本身来说，枚举常量属于标识符范畴，标识符只能由字母、数字、下划线（_）、美元符号（$）组成，且不能以数字开头，点号是完全非法的标识符字符。

解决办法

如果需要存储带点号的内容，不要把点号放到枚举常量名称里，而是通过枚举的字段来保存：

方式1：直接给常量设置字面量（简单字符串场景）

// 用合法的常量名，同时设置带点号的字面量值
rightsEnumSource.addEnumConstant("TEST").setLiteral("\"TEST.\"");

方式2：给枚举添加自定义字段（多属性场景）

// 先给枚举添加私有final的字符串字段
rightsEnumSource.addField(String.class, "value")
                .setPrivate()
                .setFinal();

// 添加枚举常量时传入带点号的字符串作为构造参数
rightsEnumSource.addEnumConstant("TEST")
                .setArguments("\"TEST.\"");

// 补充构造方法完成字段赋值
rightsEnumSource.addConstructor()
                .setPrivate()
                .addParameter(String.class, "value")
                .setBody("this.value = value;");