Java操作Access执行executeUpdate时报invalid page number错误如何解决

该错误由UCanAccess底层依赖的jackcess库抛出，核心原因是Access数据库文件的页结构损坏，请求读取的页号超出了文件实际的有效页范围，常见触发原因如下：

• 局域网共享写入冲突：Access为文件型数据库，原生不支持多客户端/多线程并发写入，将数据库文件部署在局域网共享路径时，多进程同时写入会直接破坏文件的页索引结构，导致页分配表异常
• 历史写入异常中断：之前的写入操作因程序崩溃、网络中断、进程强杀等原因中途终止，会导致部分页写入不完整，页结构出现逻辑错误
• 依赖版本兼容性问题：旧版本jackcess库存在页校验逻辑缺陷，操作高版本Access创建的accdb/mdb文件时可能误判页号有效性
• 连接使用不规范：多线程共用同一个数据库连接、未正确处理事务回滚，也可能导致写入逻辑混乱损坏文件结构

紧急修复步骤 #

• 先修复已损坏的数据库文件：打开Access客户端，通过「文件-信息-压缩和修复数据库」功能加载损坏的文件执行修复，修复完成后先在本地做单线程写入测试，确认功能正常再上线

长期规避方案 #

• 调整部署架构：如果需要多端共享数据，优先替换为MySQL、PostgreSQL等C/S架构的关系型数据库，Access天生不适合高并发共享写入场景；如果必须保留Access，将数据库文件部署在业务服务本地，不要直接放在局域网共享路径操作
• 写入加锁控制：如果必须使用共享路径部署，所有写入操作需要加全局分布式锁，保证同一时间只有一个进程/线程执行写入操作
• 代码逻辑优化：
  1. 关闭自动提交，手动管理事务，避免半写数据损坏文件，参考调整逻辑：

// 写入前关闭自动提交
connection.setAutoCommit(false);
PreparedStatement statement1 = null;
try {
    statement1 = connection.prepareStatement(sql1);
    // 原有参数赋值逻辑
    statement1.executeUpdate();
    connection.commit();
} catch (Exception e) {
    // 写入异常回滚事务
    if (connection != null) {
        connection.rollback();
    }
    e.printStackTrace();
} finally {
    if (statement1 != null) {
        statement1.close();
    }
    if (connection != null) {
        connection.close();
    }
}

2. 避免多线程共用同一个Connection连接，每个写入线程单独获取连接，操作完成后立即释放
3. 升级UCanAccess和jackcess依赖到最新稳定版，修复已知的页校验缺陷

• 运维层面定期执行Access数据库的压缩和修复操作，清理冗余页，避免文件体积异常膨胀导致页索引错误

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