Java泛型方法无法安全返回T[]，因类型擦除导致运行时实际为Object[]，强转引发ClassCastException；推荐改用List<T>、调用方传入数组或Class<T>反射创建。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

<p>Java泛型方法返回 <code>T[]</code> 时，因类型擦除无法在运行时创建真正泛型数组，JVM实际返回的是 <code>Object[]</code>，调用方接收为具体类型数组（如 <code>String[]</code>）就会触发隐式强转，导致 <code>ClassCastException</code>。根本原因不是写法错误，而是 Java 泛型的底层限制。</p>

<H3>问题本质：泛型数组创建不可行</H3>
<p>Java 不允许直接 new <code>T[]</code>（编译不通过），常见“绕过”写法如 <code>(T[]) new Object[n]</code> 或 <code>(T[]) new Comparable[n]</code>，本质都是 unchecked cast —— 编译器放行，但运行时数组的实际组件类型仍是 <code>Object</code> 或 <code>Comparable</code>，而非 <code>T</code>。当调用方声明 <code>String[] arr = method()</code>，JVM 尝试把 <code>Object[]</code> 强转为 <code>String[]</code>，失败即抛异常。</p>

<H3>推荐重构方案：避免返回泛型数组</H3>
<p>最安全、最符合泛型设计原则的方式是放弃返回 <code>T[]</code>，改用以下任一方式：</p>
<ul>
  <li><strong>返回 <code>List<T></code></strong>：利用 <code>ArrayList</code> 等实现类，类型安全且无需强转。调用方可用 <code>list.toArray(new String[0])</code> 按需转数组（此时由 <code>ArrayList</code> 内部保证类型正确）。</li>
  <li><strong>让调用方传入目标数组（类型安全）</strong>：方法签名改为 <code><T> T[] toArray(T[] a)</code>，类似 <code>Collection.toArray(T[])</code> 的标准做法。JVM 可根据传入数组的运行时类型分配/复用正确类型的数组。</li>
  <li><strong>返回 <code>Object[]</code> + 明确文档说明</strong>：若必须返回数组，返回 <code>Object[]</code> 并在 Javadoc 中强调“调用方需自行转型”，把风险显式暴露，避免隐式失败。</li>
</ul>

<H3>若必须返回 T[]：用 Class 对象构造真实类型数组</H3>
<p>通过反射可绕过擦除限制，但需调用方传入 <code>Class<T></code> 实参：</p>
<pre><code><T> T[] createArray(Class<T> type, int length) {
    @SuppressWarnings("unchecked")
    T[] array = (T[]) Array.newInstance(type, length);
    return array;
}</code></pre>
<p>调用时写成 <code>String[] arr = createArray(String.class, 5)</code>。Array.newInstance 会在运行时创建指定 <code>Class</code> 类型的真实数组，不会发生 <code>ClassCastException</code>。</p>

<H3>警惕编译器警告与 IDE 提示</H3>
<p>所有涉及 <code>(T[]) new Xxx[n]</code> 的写法都会触发 <code>Unchecked cast</code> 警告。不要用 <code>@SuppressWarnings("unchecked")</code> 掩盖它——这等于主动放弃类型检查。IDE（如 IntelliJ）通常会标红并建议替换为 <code>List</code> 或带 <code>Class</code> 参数的版本。把警告当重构信号，而不是忽略。</p>