Java中的StringIndexOutOfBoundsException解析_字符串切片时的安全保护

陌辰大大_6971

陌辰大大_6971

2026-02-23

502人浏览

原创

String.substring()越界抛StringIndexOutOfBoundsException是因为内部显式校验索引范围,不自动修正;安全做法是用Math.min限制结束位置、提前判空判长度、归一化索引或使用单参数重载。

java中的stringindexoutofboundsexception解析_字符串切片时的安全保护

String.substring() 越界时为什么抛出 StringIndexOutOfBoundsException

这个异常不是 JVM 随意抛的,而是 substring() 在内部做了显式校验:只要 beginIndex 或 endIndex 超出字符串实际长度(0 ≤ beginIndex ≤ endIndex ≤ str.length()),立刻中断执行。它不尝试“自动截断”或“静默修正”,这是 Java 字符串不可变性和边界安全的设计选择。

常见错误现象:

  • 用 str.substring(i, i + 3) 处理末尾字符时,i + 3 > str.length() 直接崩溃
  • 从正则匹配结果取 group(1) 后直接切片,但该 group 可能为 null 或空字符串
  • 用户输入含换行,line.split(" ")[0].substring(5) 在短行上失败

如何安全地做字符串切片而不崩

核心思路是把“越界”转为“可控回退”,而不是依赖 try-catch 捕获异常——后者成本高、掩盖逻辑缺陷。

实操建议:

  • 用 Math.min() 限制结束位置:str.substring(i, Math.min(i + 3, str.length()))
  • 提前判空和长度:if (str != null && str.length() > i) { ... }
  • 对不确定来源的索引,先归一化:int safeStart = Math.max(0, Math.min(i, str.length()))
  • 如果语义允许“不足就取到末尾”,优先用 substring(beginIndex) 单参数重载,它只校验 beginIndex,不涉及 endIndex 越界问题

replaceFirst() 和 split() 的隐性越界风险

这两个方法本身不抛 StringIndexOutOfBoundsException,但它们的返回值常被链式调用 substring(),从而间接触发异常。尤其在处理非预期格式数据时,风险极高。

Java Api Extractor
Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

典型场景:

  • str.replaceFirst("prefix:(\w+)", "$1").substring(0, 5) —— 若原串不含 "prefix:",replaceFirst() 返回原串,但原串可能短于 5
  • str.split(":")[1].substring(2) —— split() 结果数组长度可能为 1,[1] 就是 ArrayIndexOutOfBoundsException,虽不是字符串异常,但根源相同:没验证切片前提
  • 正则捕获组未匹配成功时,matcher.group(1) 返回 null,接着调 substring() 会触发 NullPointerException,容易误判为越界

性能与兼容性注意点

Java 9+ 的 substring() 不再共享底层 char[],所以安全包装(如 Math.min)几乎无额外开销;但在 Java 8 及更早版本中,过度使用 substring() 可能导致内存泄漏(大字符串被小子串持引用)。不过,这和越界保护无关,只是顺带提醒:别为了“保险”而无节制切片。

另外,String.charAt() 同样严格校验索引,报的也是 StringIndexOutOfBoundsException,保护方式一致,可复用同一套防御逻辑。

最易被忽略的是:日志里看到这个异常时,很多人只修 substring 调用点,却没追溯上游——那个 i 是从哪来的?是解析 JSON 的字段名长度?还是 HTTP Header 的 value 截断逻辑?根因往往不在字符串操作本身。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2215

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3522

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1176

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4059

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6899

3

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

2024.03.01

1698

6

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1838

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2904

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习