数组长度是创建时固化的元信息，代表内存分配契约而非业务约束，必须与业务长度分离管理，混用会导致越界、数据错漏或负载倾斜等系统性风险。
Java数组长度不是运行时可变的属性，而是创建时就固化在内存结构中的元信息。它直接决定索引边界、遍历范围和逻辑分支走向，一旦与业务语义脱节，轻则越界异常，重则数据错漏或负载倾斜——这不是编码习惯问题，而是系统稳健性的底层防线。
数组长度即契约：声明即承诺
动态初始化时指定的长度（如 new int[10]）不仅是内存分配指令，更是对后续所有访问逻辑的隐式契约。任何假设“数组长度足够容纳新增数据”的操作，都违背了这一契约。
- 避免用
array.length做条件判断替代真实业务约束，例如“用户最多填5个标签”应校验输入数量，而非依赖数组长度兜底 - 静态初始化时若元素数量与预期不符（如
new String[]{"a","b"}却按长度3写循环），逻辑会悄然越界或遗漏 - 将数组长度硬编码进算法（如轮询负载均衡中
index % 3）会导致节点增减后逻辑失效
length 与业务长度必须分离管理
数组长度是技术维度，而业务长度（如有效元素个数、配置项数量、服务节点实际可用数）是领域维度。二者常不一致，混用必然出错。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 动态数组场景（如日志缓冲区）：声明
new byte[8192]，但实际有效数据可能只有前1024字节，需额外维护validLength变量 - 引用类型数组初始化为
new String[5]后，部分元素仍为null，此时array.length == 5但有效字符串数可能为0～5之间 - 负载均衡器中数组存服务地址，但某节点宕机时应跳过而非计入轮询计数，需配合状态标记数组或过滤逻辑
规避 length 误用的三类典型陷阱
看似安全的 .length 访问，在特定上下文中极易引发隐蔽缺陷。
立即学习“Java免费学习笔记（深入）”；
-
空数组未判空直接遍历：
for (int i = 0; i 在 <code>arr为null时抛NullPointerException，应先判空 -
多维数组 length 理解偏差：二维数组
int[][] mat = new int[3][4]中，mat.length是3（行数），mat[0].length才是4（列数），混淆会导致矩阵遍历错位 -
字符串 length() 与字节数混淆：
"??".length()返回2（UTF-16代理对），但"??".getBytes(StandardCharsets.UTF_8).length是4，网络传输或存储限制需按字节算，不能直接用.length()
构建长度一致性检查机制
靠人工记忆或注释不可靠，需嵌入开发流程与运行时防护。
- 单元测试中显式断言关键数组长度，例如初始化后验证
assertThat(configArray.length, is(7)) - 使用
@NonNull/@Size等注解配合 Lombok 或 Jakarta Validation，在编译期或运行期拦截非法长度传入 - 自定义工具方法封装安全访问，如
safeGet(array, index, defaultValue)内部自动检查index
