IDEA編譯報錯“java: 常量字符串過長”的原因及解決方法

更新時間：2025年02月23日 13:57:47 作者：不愿放下技術的小趙

今天在開發(fā)過程中,由于嘗試將一個文件的 Base64 字符串設置為常量,結果導致 IDEA 編譯的時候出現(xiàn)了如下報錯java: 常量字符串過長,所以本文給大家記錄了IDEA編譯報錯“java: 常量字符串過長”的原因及解決方法,需要的朋友可以參考下

一、問題描述

今天在開發(fā)過程中，由于嘗試將一個文件的 Base64 字符串設置為常量，結果導致 IDEA 編譯的時候出現(xiàn)了如下報錯：

java: 常量字符串過長

在這里插入圖片描述

二、問題原因

2.1 理論角度

在 Java 中，常量字符串過長的問題通常是 由于編譯器對字符串常量的長度有限制 導致的。

眾所周知，Java代碼是由 Java編譯器（javac） 編譯為 class 字節(jié)碼之后運行的。這個報錯就是因為 javac 對字符串常量有一個上線，通常是 65534 個字符串。這個限制是由于 Java 編譯器在處理字符串常量時，使用了 16位 的無符號證書來表示字符串的長度，因此最大值為 2^16 - 1 = 65535，但實際使用中會減去一個字符的空間用于其他用途，所以最大長度為 65534。

在 IDEA 中編寫代碼時，如果定義了一個超過 65534 個字符的字符串常量，編譯器就會報錯：java: 常量字符串過長。

JVM 規(guī)范文檔： https://docs.oracle.com/javase/specs/jvms/se19/html/jvms-4.html#jvms-4.4.3

查看 JVM 規(guī)范文檔可以看到：在 Java 中，常量 String 的結構體如下：

在這里插入圖片描述

其中 string_index 指針指向常量池的一個條目，這個條目的結構體格式為 CONSTANT_Utf8_info。這個結構體的定義如下所示：

在這里插入圖片描述

由上圖可知，一個 String 類型的常量的最大長度為 2^16 - 1 = 65535，但實際使用中會減去一個字符的空間用于其他用途，所以最大長度為 65534。

2.2 源碼角度

下面我們再從 javac 源碼角度進行分析，源碼下載地址：https://jdk.java.net/java-se-ri/8-MR6。

在 \lib\src\jdk.compiler\com\sun\tools\javac\jvm|Gen.java 中可以看到如下代碼：

而這個 PoolWriter.MAX_STRING_LENGTH 的值為：

從代碼可以看到，要求小于 2^16-1，所以得出 javac 允許常量 String 保存的最大字節(jié)數為 0xFFF-1，即 2^16-1-1=65534。

三、解決方案

解決方案①：StringBuilder 拼接

我們可以使用 StringBuilder 進行字符串拼接的方式來解決這個問題，只要每次拼接的長度不超過 65534 即可。

public static String getConstant() {
    StringBuilder builder = new StringBuilder();
    builder.append("字符串1");
    builder.append("字符串2");
    // ...
    return builder.toString();
}

在線文本換行工具： https://lzltool.cn/Toolkit/WrapWordsInText

解決方案②：讀取文件內容

還有一種方式是將字符串寫入文件后讀出來，如下所示：

try (BufferedReader reader = new BufferedReader(new FileReader("longString.txt"))) {
    StringBuilder builder = new StringBuilder();
    String line;
    while ((line = reader.readLine() != null)) {
        builder.append(line);
    }
    String longString = builder.toString();
} catch (IOException e) {
    e.printStackTrace();
}

除了兩種方式，其余幾種方式小編親試均無效：