Apache NetBeans 12.3环境下创建数据库时弹出Java DB错误提示

Apache NetBeans 12.3执行Java DB（Apache Derby）建库操作时服务启动失败，核心触发因素如下：

• Java DB安装路径配置失效，NetBeans无法定位Derby启动脚本
• 默认服务端口1527被其他进程占用，Derby无法完成端口监听
• 数据库存储目录路径包含中文、空格或特殊字符，无法正常读写
• 当前使用的JDK版本与NetBeans 12.3内置的Derby版本不兼容
• 操作系统权限不足，NetBeans无权限启动服务或写入存储目录

1. 修正Java DB基础配置

• 打开服务面板，右键点击Java DB节点选择属性
• 确认Java DB安装路径指向NetBeans内置Derby目录，默认路径为<NetBeans安装目录>\java\db，路径有误则手动修正
• 重置数据库位置为全英文无特殊字符的目录，例如D:\netbeans-javadb-data

2. 排查端口占用

• Windows系统打开命令提示符执行命令：netstat -ano | findstr :1527
• Linux/macOS系统执行命令：lsof -i :1527
• 若端口被占用，可关闭对应占用进程，或在Java DB属性的启动参数栏添加-p 1528，切换至空闲端口

3. 解决兼容与权限问题

• 右键点击NetBeans启动程序，选择以管理员身份运行后重试操作
• 若使用JDK 17及以上版本，需下载兼容版本的Apache Derby，替换NetBeans安装目录下java\db内的原有文件，重启NetBeans后再尝试建库

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