MiniExcel项目DataReader.GetOrdinal方法返回值异常问题分析

问题概述

在MiniExcel项目1.36.1版本中，用户报告了一个关于DataReader.GetOrdinal方法的行为变更问题。该方法在读取Excel文件时，无论传入什么列名参数，总是返回0值，这与之前版本返回正确列索引的行为不符。

技术背景

MiniExcel是一个轻量级的Excel处理库，提供了类似ADO.NET中DataReader的接口来读取Excel数据。GetOrdinal方法是DataReader接口的重要成员，用于根据列名获取对应的列索引位置。

在标准ADO.NET实现中，GetOrdinal方法应该：

1. 接收列名字符串作为参数
2. 返回该列在结果集中的从零开始的序号
3. 如果找不到列名则抛出异常

问题表现

在1.36.1版本中，即使用户明确设置了useHeaderRow为false，GetOrdinal方法仍然无法正确返回列索引。测试代码显示，无论传入什么列名，该方法总是返回0，这显然不符合预期行为。

影响范围

此问题会影响所有依赖GetOrdinal方法返回值进行列定位的代码。特别是：

• 动态列处理的逻辑
• 基于列名而非列序号的访问方式
• 需要精确列定位的数据转换代码

临时解决方案

项目维护者建议用户暂时回退到1.36.0版本，因为1.36.1版本主要是新增功能而非修复关键bug。用户可以通过固定NuGet包引用来实现版本回退。

技术建议

对于遇到此问题的开发者，建议：

1. 检查项目中是否使用了GetOrdinal方法
2. 如果依赖此方法，暂时锁定MiniExcel版本为1.36.0
3. 等待官方发布修复版本后再进行升级
4. 考虑在代码中添加对返回值的验证逻辑，增强健壮性

总结

这个案例提醒我们在进行库版本升级时需要注意：

• 即使是小版本号变更也可能引入行为变更
• 升级后需要进行充分的回归测试
• 关注开源项目的issue跟踪，及时了解已知问题
• 保持对依赖库版本的灵活控制能力

对于MiniExcel用户来说，目前只需暂时停留在1.36.0版本即可避免此问题，等待后续修复版本发布后再考虑升级。