Spring Boot启动报URL必须以jdbc开头错误,升级Java15后VM参数未生效怎么办
报错根因说明
- 抛出
java.lang.IllegalArgumentException: URL must start with 'jdbc'的直接原因,是Spring Boot实际读取到的spring.datasource.url没有成功替换占位符,拿到的是空值或者不含jdbc前缀的无效内容。 - 你观察到的「传入的VM参数完全不被项目解析」现象,和升级Java 15、IntelliJ Community版的参数传递逻辑不兼容直接相关,不属于Spring Boot框架本身的问题。
具体问题原因定位
- Java 15 对带引号的VM参数解析规则变更:Java 8/11等长期支持版本下,JVM会自动剥离VM参数值外层的成对双引号;但Java 15之后,IntelliJ Community版拼接启动脚本时,不会再自动剥离手动添加的双引号,反而会把带双引号的整段内容识别为脚本的边界标识,导致这几个
-D开头的系统属性根本没有被注册到JVM系统属性里,占位符自然无法完成替换。 - 旧运行配置的缓存兼容问题:升级Java版本后,IntelliJ保留的原有Spring Boot启动配置没有同步更新参数拼接逻辑,沿用旧版本的传参规则,和Java 15的启动规范不匹配,就会出现VM参数被整体忽略的情况。
- 高优先级配置覆盖的次要可能:如果项目根目录存在本地profile配置、或者操作系统环境变量中已经设置了同名的
JDBC_DATABASE_URL等值,配置优先级会高于VM参数,也会出现手动传入的VM参数不生效的情况,这类场景和Java版本升级的时间节点关联度低,属于次要排查项。
可直接落地的排查解决步骤
- 修正VM参数的写法,删除参数值外层的所有双引号
正确的参数格式为:
高版本JVM原生支持带特殊字符的参数值直接传入,不需要额外加双引号做转义,手动加的双引号反而会触发IntelliJ的参数解析逻辑异常。-DJDBC_DATABASE_URL=jdbc:postgresql://localhost:5432/project -DJDBC_DATABASE_USERNAME=postgres -DJDBC_DATABASE_PASSWORD=postgres - 确认VM参数填写位置正确
- IntelliJ Community版的Spring Boot运行配置中,VM参数需要填写在
VM options输入框内,不能填在Program arguments(程序参数)、Environment variables(环境变量)板块 - 如果看不到
VM options输入框,点击运行配置面板的Modify options,勾选Add VM options即可调出输入框
- IntelliJ Community版的Spring Boot运行配置中,VM参数需要填写在
- 清理旧的运行配置缓存
- 打开Run/Debug Configurations面板,删除之前留存的旧Spring Boot启动配置
- 重新通过主类入口或者Maven插件创建新的启动配置,重新填写调整后的VM参数,避免旧配置的缓存逻辑和Java 15的启动规则不兼容
- 兜底验证环节
如果调整完参数后依然无法解析,可临时把数据源信息硬编码写入application.properties,验证基础配置是否能正常启动:
硬编码配置能正常启动的话,即可确认问题完全出在参数传递环节,和框架配置本身无关。spring.datasource.url=jdbc:postgresql://localhost:5432/project spring.datasource.username=postgres spring.datasource.password=postgres
内容的提问来源于stack exchange,提问作者Futureflo
相关产品推荐
相关产品推荐

