POI获取相对行引用命名区域公式异常问题求助

问题现象 #

使用Apache POI 5.2.5获取命名区域的引用公式时：

• 定义指向相对行引用（如=Sheet1!2:2）的命名区域test_row，调用namedRange.getRefersToFormula()返回Sheet1!1048576:1048576（Excel最大行号）
• 相对列引用（如=A:A）的命名区域可正常获取公式
• 绝对行引用（如=$2:$2/=Sheet1!$2:$2）无异常

测试环境：poi:5.2.5、poi-ooxml:5.2.5、poi-ooxml-schemas:4.1.2、openjdk21.0.2

原因 #

这是POI处理相对行引用的已知bug：命名区域的相对行引用在缺少绝对引用标记$时，POI会错误地将其解析为基于Excel最大行号（1048576）的相对引用，而相对列引用的处理逻辑不存在该偏差。

解决方案 #

1. 强制使用绝对行地址 #

定义命名区域时添加$标记，比如=$2:$2或=Sheet1!$2:$2，这是最直接的规避方式，已验证有效。

2. 手动修正解析结果 #

若无法修改原文件的命名区域定义，可通过正则匹配+手动替换修正错误结果：

import java.util.regex.Matcher;
import java.util.regex.Pattern;
import org.apache.poi.ss.usermodel.Name;

// 假设namedRange是已获取的命名区域对象
Name namedRange = ...;
String refersTo = namedRange.getRefersToFormula();

// 匹配无$标记的相对行引用
Pattern rowPattern = Pattern.compile("([^!]+!)?(\\d+):(\\d+)");
Matcher matcher = rowPattern.matcher(refersTo);

if (matcher.matches() && !refersTo.contains("$")) {
    // 替换为正确的行号（这里假设你已知原始目标行号为2，可根据实际场景调整）
    String correctedFormula = matcher.replaceFirst("$12:2");
    // 使用correctedFormula作为正确的引用公式
}

3. 升级POI版本 #

尝试升级到POI 5.2.6及以上版本，后续版本已修复部分相对引用解析的bug，可解决该问题。

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