Spring Boot配置server.address绑定局域网IP启动报错如何解决
问题根因
你遇到的java.net.BindException: Cannot assign requested address报错,本质是你在application.properties里配置的server.address值不是当前运行Spring Boot服务的机器上网卡绑定的有效局域网IP,系统无法把服务绑定到一个不属于本机的IP上。
修复步骤
- 第一步:查询本机的有效局域网IP
- Windows系统:打开cmd执行
ipconfig,找到你正在使用的网卡(如WiFi/以太网)对应的IPv4地址,一般为192.168.x.x、10.x.x.x网段 - Linux/macOS系统:打开终端执行
ifconfig或者ip addr,找到对应工作网卡的IPv4地址
- Windows系统:打开cmd执行
- 第二步:把
application.properties里的server.address值修改为上一步查到的本机真实局域网IP,保存配置 - 第三步:重新启动Spring Boot项目即可正常启动,同局域网下的其他设备可以通过该IP+端口访问你的服务
通用免修改方案
如果不想每次切换网络环境都手动改server.address,可以直接配置server.address=0.0.0.0,该配置会让服务绑定到本机所有可用网卡地址上,既支持localhost本地访问,也支持用本机局域网IP对外提供访问,非常适合开发阶段使用。
补充说明
Spring Boot完全支持绑定指定局域网IP运行,只要绑定的IP是本机网卡的有效地址就可以正常运行,无技术限制。
内容的提问来源于stack exchange,提问作者3UMF
相关产品推荐
相关产品推荐

