本文详解 thymeleaf 中遍历字符串时常见的索引越界错误，提供三种安全、简洁的解决方案：修正序列范围、使用数组下标语法、以及直接遍历字符数组。
本文详解 thymeleaf 中遍历字符串时常见的索引越界错误，提供三种安全、简洁的解决方案：修正序列范围、使用数组下标语法、以及直接遍历字符数组。
在 Thymeleaf 模板中对字符串进行逐字符遍历时，一个常见误区是误用 #numbers.sequence() 生成索引序列，导致 String.charAt(i) 抛出 IndexOutOfBoundsException。例如以下写法会报错：
<div th:each="i: ${#numbers.sequence(0, #strings.length(name))}">
<p th:text="${name.charAt(i)}"></p>
</div>
问题根源在于：#numbers.sequence(start, end) 的 end 参数是包含边界（inclusive），而字符串索引是 0-based，合法范围为 0 到 length - 1。因此当 #strings.length(name) 返回 5（如 "Hello"），sequence(0, 5) 会生成 [0,1,2,3,4,5] —— 最后一个索引 5 已超出字符串边界，调用 name.charAt(5) 必然失败。
✅ 正确做法一：修正序列终点
将终点减 1，确保索引不越界：
<div th:each="i: ${#numbers.sequence(0, #strings.length(name) - 1)}">
<p th:text="${name[i]}"></p> <!-- 推荐用 [] 而非 charAt() -->
</div>
? 提示：Thymeleaf 支持直接使用 string[index] 语法访问字符（底层调用 String.charAt()），更简洁且语义清晰，无需额外方法调用。
✅ 正确做法二：零索引抽象 —— 直接遍历字符数组
彻底规避索引管理，利用 Java 的 toCharArray() 将字符串转为字符数组后迭代：
<div th:each="c: ${name.toCharArray()}">
<p th:text="${c}"></p>
</div>
该方式最直观、安全，且可读性高，适用于绝大多数逐字符渲染场景（如字母动画、密码强度提示等）。
⚠️ 注意事项：
- 避免在模板中执行复杂逻辑或空值未判操作。若 name 可能为 null，应先做防护处理，例如：
<div th:if="${name != null}"> <div th:each="c: ${name.toCharArray()}">...</div> </div> - #strings.length(null) 会返回 0，但 null.toCharArray() 会抛出 NullPointerException，务必区分使用场景。
综上，推荐优先采用 toCharArray() 遍历方式；若需索引（如标注位置、奇偶样式），则务必使用 #numbers.sequence(0, len - 1) 并配合 string[i] 语法，兼顾健壮性与可维护性。
