本文详解修复 apache poi 读取 excel 时因文件扩展名判断错误导致的 `nullpointerexception`，并提供健壮、可复用的数据驱动测试代码，涵盖 `.xls`/`.xlsx` 兼容处理、空单元格防护、资源释放及最佳实践。

在使用 Apache POI 实现 Selenium 数据驱动自动化测试时，一个常见却极易被忽视的错误是文件扩展名字符串匹配不准确，这将直接导致 Workbook 对象初始化失败，进而引发 NullPointerException ——正如您遇到的错误：

java.lang.NullPointerException: Cannot invoke "org.apache.poi.ss.usermodel.Workbook.getSheet(String)" because "loginWorkbook" is "null"

根本原因在于 readExcel() 方法中对 .xls 扩展名的判断逻辑存在硬编码缺陷：

else if(fileExtension.equals("xls")) // ❌ 错误：缺少前导点号

由于 fileName.substring(fileName.indexOf(".")) 返回的是类似 ".xls" 或 ".xlsx" 的完整扩展名（含英文句点），而代码中却错误地与 "xls"（无点）比较，导致条件始终为 false，loginWorkbook 保持 null，后续调用 getSheet() 必然崩溃。

✅ 正确写法应为：

else if (fileExtension.equalsIgnoreCase(".xls"))

同时，为提升健壮性与可维护性，我们建议对原始代码进行以下关键优化：

✅ 完整修正版（含增强功能）

package com.framework;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.time.Duration;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;

public class DataDriveFramework {

    public void readExcel(String filePath, String fileName, String sheetName) throws IOException {
        File file = new File(filePath + File.separator + fileName); // 使用 File.separator 提升跨平台兼容性
        if (!file.exists()) {
            throw new IOException("Excel file not found: " + file.getAbsolutePath());
        }

        FileInputStream fis = null;
        Workbook workbook = null;
        try {
            fis = new FileInputStream(file);
            String fileExtension = fileName.substring(fileName.lastIndexOf(".")).toLowerCase();

            if (fileExtension.equals(".xlsx")) {
                workbook = new XSSFWorkbook(fis);
            } else if (fileExtension.equals(".xls")) {
                workbook = new HSSFWorkbook(fis);
            } else {
                throw new IllegalArgumentException("Unsupported file format: " + fileExtension);
            }

            Sheet sheet = workbook.getSheet(sheetName);
            if (sheet == null) {
                throw new IllegalArgumentException("Sheet not found: " + sheetName);
            }

            int firstRowNum = sheet.getFirstRowNum();
            int lastRowNum = sheet.getLastRowNum();

            // 从第1行开始（跳过表头），确保行存在且非空
            for (int i = firstRowNum + 1; i <= lastRowNum; i++) {
                Row row = sheet.getRow(i);
                if (row == null) continue; // 跳过空行

                // 安全读取单元格：处理 null、blank 和不同数据类型
                String username = getCellStringValue(row.getCell(0));
                String password = getCellStringValue(row.getCell(1)); // ⚠️ 注意：原代码误用 getCell(0) 两次！

                if (username != null && !username.trim().isEmpty() && 
                    password != null && !password.trim().isEmpty()) {
                    test(username, password);
                }
            }

        } finally {
            // 确保资源释放
            if (fis != null) fis.close();
            if (workbook != null) workbook.close();
        }
    }

    // 辅助方法：安全获取字符串值，兼容 STRING、NUMERIC、BLANK 等类型
    private String getCellStringValue(Cell cell) {
        if (cell == null) return null;
        switch (cell.getCellType()) {
            case STRING:
                return cell.getStringCellValue().trim();
            case NUMERIC:
                if (DateUtil.isCellDateFormatted(cell)) {
                    return cell.getDateCellValue().toString();
                } else {
                    return String.valueOf((long) cell.getNumericCellValue()).trim();
                }
            case BLANK:
                return "";
            default:
                return cell.toString().trim();
        }
    }

    public void test(String username, String password) {
        WebDriver driver = new FirefoxDriver();
        try {
            driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10));
            driver.get("https://accounts.google.com");

            // 更稳定的定位方式（避免绝对XPath）
            driver.findElement(By.id("identifierId")).sendKeys(username);
            driver.findElement(By.id("identifierNext")).click(); // 替换为语义化
ID

            // 显式等待密码框出现（推荐配合 WebDriverWait）
            Thread.sleep(2000); // 简化示例，生产环境请用 WebDriverWait
            driver.findElement(By.name("Passwd")).sendKeys(password); // 改用 name 属性更稳定
            driver.findElement(By.id("passwordNext")).click();

            // 可添加断言验证登录成功（如检查URL或元素）
            Thread.sleep(3000);

        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            driver.quit(); // 每次测试后关闭浏览器
        }
    }

    public static void main(String[] args) throws IOException {
        DataDriveFramework framework = new DataDriveFramework();
        String filePath = "C:\\Users\\Shefali\\eclipse-workspace\\DataDriveFramework\\TestExcelSheet\\";
        framework.readExcel(filePath, "DataDriven.xls", "Sheet1");
    }
}

? 关键改进说明

• ✅ 修复核心 Bug：".xls" 字符串严格匹配，避免 loginWorkbook 为 null；
• ✅ 安全单元格读取：getCellStringValue() 处理 null、空、数字、日期等类型，防止 NullPointerException 或 IllegalStateException；
• ✅ 资源自动释放：try-finally 确保 FileInputStream 和 Workbook 正确关闭；
• ✅ 健壮性增强：校验文件存在、Sheet 存在、跳过空行、过滤空用户名/密码；
• ✅ 定位策略优化：避免脆弱的绝对 XPath，优先使用 id/name 等稳定属性；
• ✅ 跨平台兼容：使用 File.separator 替代硬编码 "\\"；
• ✅ 异常明确提示：对不支持格式、缺失 Sheet 等场景抛出清晰异常。

⚠️ 注意事项（务必遵守）

• 不要在循环内反复创建/销毁 WebDriver：当前示例为简化演示；真实项目应使用 @BeforeMethod/@AfterMethod（TestNG）或 BeforeEach/AfterEach（JUnit5）统一管理 driver 生命周期，或采用线程安全的 ThreadLocal；
• 禁止硬编码测试 URL 和凭证：敏感信息应通过 Properties、YAML 或环境变量注入；
• 避免 Thread.sleep()：生产环境必须改用 WebDriverWait 配合 ExpectedConditions 实现智能等待；
• Excel 文件需保持打开状态？否！ 运行测试前请确保 Excel 文件未被其他程序（如 Excel 应用）独占锁定，否则 FileInputStream 会抛出 IOException。

通过以上修正与增强，您的数据驱动框架将具备生产级稳定性与可维护性。记住：一个健壮的自动化框架，始于对每一个 null 的敬畏，成于对每一处资源的负责。

# word  # excel  # java  # go  # apache  # 编码  # 浏览器  # ai  # switch  # eclipse  # 环境变量  # NULL  # try  # 字符串  # 循环  # finally  # 线程  # Thread  # 对象  # bug  # 自动化  # 跳过  # 单元格  # 扩展名  # 抛出  # 的是  # 您的  # 文件扩展名  # 两次  # 健壮性  # 英文 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 佛山网站制作系统,佛山企业变更地址网上办理步骤？  HTML5空格和nbsp有啥关系_nbsp的作用及使用场景【说明】  Laravel如何实现API版本控制_Laravel版本化API设计方案  如何在阿里云完成域名注册与建站？  Laravel怎么配置自定义表前缀_Laravel数据库迁移与Eloquent表名映射【步骤】  Win11怎样安装网易有道词典_Win11安装词典教程【步骤】  Linux系统命令中tree命令详解  零基础网站服务器架设实战：轻量应用与域名解析配置指南  html5如何设置样式_HTML5样式设置方法与CSS应用技巧【教程】  如何用景安虚拟主机手机版绑定域名建站？  EditPlus中的正则表达式实战(5)  如何生成腾讯云建站专用兑换码？  如何快速完成中国万网建站详细流程？  Laravel软删除怎么实现_Laravel Eloquent SoftDeletes功能使用教程  Laravel如何编写单元测试和功能测试？（PHPUnit示例）  Laravel怎么配置.env环境变量_Laravel生产环境敏感数据保护与读取【方法】  如何在万网自助建站平台快速创建网站？  如何在建站之星网店版论坛获取技术支持？  公司网站制作价格怎么算,公司办个官网需要多少钱？  如何在万网ECS上快速搭建专属网站？  linux top下的 minerd 木马清除方法  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  google浏览器怎么清理缓存_谷歌浏览器清除缓存加速详细步骤  Laravel Eloquent性能优化技巧_Laravel N+1查询问题解决  香港服务器WordPress建站指南：SEO优化与高效部署策略  晋江文学城电脑版官网 晋江文学城网页版直接进入  Laravel怎么使用Collection集合方法_Laravel数组操作高级函数pluck与map【手册】  LinuxShell函数封装方法_脚本复用设计思路【教程】  如何正确选择百度移动适配建站域名？  佛山企业网站制作公司有哪些,沟通100网上服务官网？  制作企业网站建设方案,怎样建设一个公司网站？  如何快速搭建FTP站点实现文件共享？  JS中对数组元素进行增删改移的方法总结  Laravel与Inertia.js怎么结合_使用Laravel和Inertia构建现代单页应用  Laravel如何发送邮件_Laravel Mailables构建与发送邮件的简明教程  如何在 Telegram Web View（iOS）中防止键盘遮挡底部输入框  如何在新浪SAE免费搭建个人博客？  javascript基于原型链的继承及call和apply函数用法分析  Laravel中的Facade(门面)到底是什么原理  如何在万网开始建站？分步指南解析  Laravel定时任务怎么设置_Laravel Crontab调度器配置  移动端脚本框架Hammer.js  Laravel如何实现本地化和多语言支持？（i18n教程）  网站广告牌制作方法,街上的广告牌，横幅，用PS还是其他软件做的？  在线制作视频网站免费,都有哪些好的动漫网站？  Laravel如何创建自定义Artisan命令？（代码示例）  头像制作网站在线观看,除了站酷，还有哪些比较好的设计网站？  如何在腾讯云服务器上快速搭建个人网站？  七夕网站制作视频,七夕大促活动怎么报名？  如何在阿里云香港服务器快速搭建网站？