Java 16与Gradle 7.0使用char类型'ß'出现编译错误的原因及解决方法

• 你遇到的unclosed character literal报错100%是编译环节的编码不匹配导致的，和字符本身的存储逻辑没有关系。
• Java编译器读取.java源文件时，必须使用和文件实际保存格式一致的编码解析字节流。Windows环境下Java 16的默认编译编码为windows-1252，这是一种单字节编码：你源文件里写的'ß'、'ẞ'在UTF-8格式下分别占2个、3个字节，编译器用单字节编码解析时，会把闭合的单引号位置识别错，最终判定为“字符字面量未闭合”。
• 你在build.gradle中添加的compileJava.options.encoding = "UTF-8"本质就是强制编译器用UTF-8读取源文件，这也是配置完成后编译错误直接消失的原因。同版本Java、同版本Gradle的其他设备能正常编译，是因为那些设备的系统默认编码为UTF-8，编译器可以自动匹配源文件编码，不需要手动配置。

你之前观察到的“ß、ẞ、ä、ö、ü占两个char存储单元”是编码错位导致的误判，并不是Java的原生存储逻辑：

• Java的char是固定16位（2字节）的无符号值，对应Unicode编码的BMP（基本多文种平面）字符。所有BMP范围内的字符，调用toCharArray()都会返回长度为1的char数组；只有超出BMP的辅助平面字符，才需要用两个连续的char值（代理对）表示，此时数组长度才为2。
• 你测试的所有字符的实际Unicode属性：
  • ß：编码U+00DF，属于BMP，UTF-8下占2个字节但对应单个char，toCharArray()返回长度为1的数组；
  • ẞ：编码U+1E9E，属于BMP，同样对应单个char，数组长度为1；
  • ä/ö/ü：都是U+00XX范围的BMP字符，单char存储，不存在占两个char单元的情况。
• IntelliJ提示"ß".toCharArray()[1]必然抛出ArrayIndexOutOfBoundsException是完全正确的——它是基于字符的实际编码规则做的静态判断，和你运行时编码错位导致的错误结果无关。你之前看到的长度为2的数组结果、乱码输出，全是windows-1252编码无法正确解析UTF-8字节序列导致的。你猜测的“System.out默认用UTF-8编码、字符占两个字节导致问题”是完全反过来的：实际是System.out默认跟随JVM的windows-1252编码，遇到无法解码的UTF-8字节序列就会输出乱码、解析错位，并不是字符本身占了两个char单元。

• 你配置的compileJava.options.encoding仅作用于编译器读取源文件的环节，完全不会影响JVM启动后的运行时默认编码。Java 18之前，JVM的file.encoding默认跟随操作系统本地编码，Windows环境下默认就是windows-1252，和编译配置没有任何关联。
• 当你同时配置编译编码为UTF-8、JVM启动参数指定file.encoding=UTF-8时，编译器可以正确读取源文件的UTF-8字符，JVM运行时也能用UTF-8解码字节、输出内容，全流程就不会出现乱码和解析错误了。
• 如果要统一运行时编码，不需要依赖全局配置也可以实现：
  • 启动JVM时添加参数-Dfile.encoding=UTF-8，Java 16完整支持该参数；
  • 不依赖全局编码配置，显式指定输出流编码，即你代码中写的new PrintStream(System.out, true, StandardCharsets.UTF_8)，这种方式兼容性更强；
  • 升级到Java 18及以上版本，该版本开始JVM默认的file.encoding统一为UTF-8，不再跟随系统本地编码。

你之前的测试结果已经体现了JDK原生的大小写映射规则：

• 默认情况下，Character.toUpperCase('ß')会固定返回小写ß，而字符串的toUpperCase()方法会把ß替换为两个连续的S（即你看到的"aß".toUpperCase(Locale.ROOT)输出ASS），不会映射为单个大写ẞ。这是历史设计遗留：大写ẞ是2010年才被纳入Unicode标准的，远晚于Java最初的大小写映射表设计，旧版规则为了兼容传统德语的书写习惯，一直保留了“ß转大写为SS”的逻辑。
• 如果不需要自己实现转换逻辑，可以直接利用JDK内置的本地化映射：
  • 传入德国本地语言环境执行转换："ß".toUpperCase(Locale.GERMANY)，该场景下JDK会将单个ß映射为大写ẞ，而非替换为SS。

注意：不要试图用单char的API实现这个转换，因为大小写映射本质是字符串级别的规则，单char的API无法覆盖多字符转换、语言环境相关的映射逻辑。

内容的提问来源于stack exchange，提问作者Schesam