本文详解 Thymeleaf 中遍历字符串时因索引越界导致的 ParseException 错误，提供三种安全、简洁的解决方案：修正序列范围、使用数组下标语法、以及直接遍历字符数组。
本文详解 thymeleaf 中遍历字符串时因索引越界导致的 `parseexception` 错误，提供三种安全、简洁的解决方案：修正序列范围、使用数组下标语法、以及直接遍历字符数组。
在 Thymeleaf 模板中，若想将字符串（如变量 name）按字符逐个渲染，常见的错误写法是：
<div th:each="i: ${#numbers.sequence(0, #strings.length(name))}">
<p th:text="${name.charAt(i)}"></p>
</div>
该代码会抛出 org.attoparser.ParseException，根本原因在于：#numbers.sequence(start, end) 生成的是包含首尾端点的闭区间序列，而 #strings.length(name) 返回字符串长度（例如 "abc" 长度为 3），此时 sequence(0, 3) 产生 [0, 1, 2, 3] —— 当 i = 3 时调用 name.charAt(3) 超出索引范围（合法索引为 0 至 length - 1），引发运行时异常。
✅ 正确做法一：修正序列终点
将终点设为 #strings.length(name) - 1，确保索引不越界：
<div th:each="i: ${#numbers.sequence(0, #strings.length(name) - 1)}">
<p th:text="${name[i]}"></p> <!-- 推荐用 [] 代替 charAt() -->
</div>
✅ 提示：Thymeleaf 支持对字符串使用 [] 下标语法（如 name[i]），语义清晰且无需调用 charAt() 方法，更简洁安全。
✅ 正确做法二：直接遍历字符数组
利用 String.toCharArray() 获取字符数组，由 Thymeleaf 原生支持迭代：
<div th:each="c: ${name.toCharArray()}">
<p th:text="${c}"></p>
</div>
此方式完全规避索引管理，语义最直观，也最符合模板引擎“声明式遍历”的设计哲学。
⚠️ 注意事项：
- #numbers.sequence 的 end 参数是包含性的，务必减 1；
- 避免在模板中执行复杂逻辑（如嵌套方法调用），优先选择语义化、可读性强的表达式；
- 若 name 可能为 null，需前置判空（如 th:if="${name != null}"），否则 toCharArray() 或 [] 访问会触发 NPE。
综上，推荐优先采用 th:each="c: ${name.toCharArray()}" 方案——它简洁、安全、无索引风险，是 Thymeleaf 中处理字符串遍历的最佳实践。
