Java嵌入式Derby数据库运行一段时间后启动失败问题咨询

• 锁文件残留：Derby嵌入式模式运行时会在数据库目录生成db.lck和dbex.lck锁文件，用于避免多进程同时访问数据库。如果应用进程被强制杀死、异常崩溃，或者复制了正在运行的数据库文件夹，锁文件不会被正常删除。嵌入式驱动启动时检测到锁文件存在就会认为数据库已被占用，抛出40000错误启动失败。而NetBeans的Java DB网络服务会自动校验锁的有效性，清理无效残留锁，因此ClientDriver可以正常连接。
• 驱动版本不兼容：如果打包到应用里的EmbeddedDriver版本，和你本地开发环境用的Derby版本不一致，用户端运行过程中高版本驱动会修改数据库元数据，低版本的嵌入式驱动无法识别修改后的元数据，就会启动失败。NetBeans自带的Java DB服务版本和你开发环境一致，因此可以正常访问。
• 文件权限不足：你将数据库从用户设备复制回开发设备时，文件夹的读写权限没有同步，嵌入式驱动需要读写数据库目录下的所有文件，权限不足会导致数据库启动失败。NetBeans的Java DB服务通常以更高权限运行，不受普通用户权限限制。
• 相对路径解析错误：你代码中使用的连接字符串jdbc:derby:db_name是相对路径，依赖应用的工作目录，如果你放置数据库的路径和工作目录不匹配，驱动找不到数据库文件也会报启动失败的错误。

1. 关闭所有访问该数据库的进程，打开数据库目录，手动删除db.lck和dbex.lck两个锁文件，再用嵌入式驱动尝试连接。
2. 统一本地开发环境和打包应用的Derby依赖版本，确保两端驱动完全一致。
3. 给数据库目录及所有子文件、子目录开通当前运行用户的完整读写权限。
4. 临时将连接字符串修改为数据库的绝对路径，比如jdbc:derby:C:/test/db_name，验证是否是相对路径解析错误导致的问题。

• 应用退出时必须显式关闭Derby数据库：在应用的关闭钩子中添加执行关闭的代码：DriverManager.getConnection("jdbc:derby:;shutdown=true")，保证数据库正常关闭，自动清理锁文件。
• 禁止复制运行状态的数据库，所有数据库复制操作必须在数据库完全关闭、锁文件已清理后执行。
• 全流程固定Derby依赖版本，开发、测试、生产打包都使用同一版本的Derby驱动，避免版本差异带来的元数据兼容问题。
• 连接字符串优先使用可配置的绝对路径，避免依赖应用工作目录，防止路径解析错误。
• 应用启动时可增加锁文件校验逻辑：如果当前没有正在运行的数据库连接，先检测数据库目录下是否有残留锁文件，确认无效后先清理再启动数据库连接。

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