Java DecimalFormat 的 parse 为什么可能只消费输入前缀

我第一次遇到这个现象，是在导入带备注的金额字段时：输入是 123.45元，DecimalFormat.parse 却返回了一个看起来完全合理的数字。问题不在小数精度，而在于“返回一个 Number”和“消费完整字符串”是两件事。

结论：默认解析只要能从起始位置读出一个合法数字，就可能在遇到不属于数字的字符时停下，并把已经读到的前缀交给调用方。要做整串校验，必须检查 ParsePosition 的消费位置；Java 23 及以后还可以用 setStrict(true) 收紧格式规则。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/DecimalFormat.html

返回值正常，不代表输入已经完整消费

Oracle API 对 parse(String, ParsePosition) 的描述很明确：解析从 ParsePosition 的 index 开始，成功后 index 更新到“最后使用字符之后”，而且不一定使用到字符串末尾。于是 123.45元 可以得到数值 123.45，但“元”仍然留在输入里。

这是一种有意保留的解析模型，适合从一段文本中连续读取多个数字。例如上一次解析结束的位置，可以作为下一次解析的起点。真正容易出错的是把这种“前缀解析器”当成严格的整字段校验器。

ParsePosition 才是判断边界的关键证据

如果业务要求整个字段只能是一个数字，就不要只写 format.parse(text)。把起点设为 0，解析后同时检查返回值、错误位置和最终 index：最终 index 必须等于输入长度，才说明没有遗留字符。

import java.text.DecimalFormat;
import java.text.ParsePosition;

public final class StrictNumberParser {
    public static Number parseWholeNumber(String text) {
        DecimalFormat format = new DecimalFormat("#,##0.##");
        // strict 负责收紧格式规则；完整消费仍由 index 判断。
        format.setStrict(true);

        ParsePosition position = new ParsePosition(0);
        Number value = format.parse(text, position);
        // null 表示解析失败，errorIndex 可帮助定位失败字符。
        if (value == null || position.getErrorIndex() >= 0) {
            throw new IllegalArgumentException("无法解析数字：" + text);
        }
        // 只消费前缀时，index 会小于输入长度，不能放行。
        if (position.getIndex() != text.length()) {
            throw new IllegalArgumentException("数字后存在未消费字符：" + text);
        }
        return value;
    }
}

这里的判断顺序有两个好处：先处理解析失败，再处理“解析成功但没有读完”的情况。不要用返回类型是 Long 还是 Double 来判断完整性；官方文档说明，默认配置下整数值可能返回 Long，无法放入 Long 的值或带小数的值可能返回 Double，这与是否消费完整字符串无关。

strict 模式解决什么，不能解决什么

DecimalFormat 默认是 lenient，也就是宽松解析。Java 23 起提供 isStrict 和 setStrict，strict 会进一步检查前缀、后缀、分组符号以及不应出现的字符。例如货币格式缺少 $，或分组位置不符合规则时，严格模式会让解析失败。

但工程上我仍会保留 position.getIndex() == text.length()。原因很简单：strict 是格式语义的收紧开关，而“输入必须完整消费”是字段边界策略。把两者分开写，代码意图更清楚，也不会因为更换 pattern、Locale 或 JDK 行为而误把尾部内容当成合法字段。

我会怎样选择解析方式

• 只想从一段文本的开头读出数字：可以接受前缀解析，但要保留新的 ParsePosition。
• 校验表单、配置或接口字段：检查 index == text.length()，必要时启用 strict。
• 要求十进制精确值：再考虑 setParseBigDecimal(true)，不要把类型选择和完整性判断混在一起。
• 多线程共享格式器：不要直接共享 DecimalFormat；官方建议每个线程使用独立实例，或在外部同步。

一句话记忆：parse 告诉你“前面读出了什么”，ParsePosition 告诉你“读到了哪里”。只要业务要求整串合法，最终位置就必须成为显式判断。

相关问题

为什么输入带中文单位还能返回数字？ 因为宽松解析可以在合法数字前缀结束处停止，单位字符没有被消费。

只调用 setStrict(true) 就够了吗？ 不建议这样假设。strict 收紧格式约束，完整字段仍应检查 ParsePosition 的最终 index。