Spring Boot中server.port配置应用端口(默认8080,设为0则随机),server.servlet.context-path配置URL统一前缀(如/api),二者组合构成完整访问路径,且2.0+版本必须使用后者,旧版server.context-path已废弃。

Spring Boot 中配置应用端口和访问路径非常直接,核心是通过 server.port 和 server.servlet.context-path 两个属性控制。它们分别决定服务监听哪个端口、以及整个应用的根路径前缀。
配置端口(server.port)
指定应用启动时绑定的 HTTP 端口,默认是 8080。修改后,服务将只响应该端口的请求。
-
application.properties 方式:
在src/main/resources/application.properties中添加:server.port=8088 -
application.yml 方式:
在src/main/resources/application.yml中添加:server:<br> port: 8088
- 特殊值:设为 0 表示启用随机端口,适合测试或容器化部署,避免端口冲突。
配置访问路径(server.servlet.context-path)
这个属性定义整个 Spring Boot Web 应用的上下文路径(即 URL 的统一前缀),它会自动加在所有 Controller 映射路径之前。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
application.properties 示例:
server.servlet.context-path=/api -
application.yml 示例:
server:<br> servlet:<br> context-path: /api
- 配置后,原本
@RequestMapping("/user")的接口,需通过http://localhost:8088/api/user访问。 -
注意:Spring Boot 2.0+ 必须使用
server.servlet.context-path;1.x 版本用的是server.context-path,已废弃。
组合使用与访问效果
当两者同时配置时,最终访问地址 = 协议 + 主机 + 端口 + context-path + Controller 路径。
- 例如:
server.port=9001server.servlet.context-path=/shop
且 Controller 写了@GetMapping("/order/{id}"),则完整路径为:http://localhost:9001/shop/order/123 - 启动日志中会明确提示:
Tomcat started on port(s): 9001 (http) with context path '/shop'
其他生效方式(补充)
除配置文件外,还可通过以下方式动态指定,优先级通常高于配置文件:
-
命令行参数:启动 jar 包时加
--server.port=8089 --server.servlet.context-path=/v2 -
环境变量:设置
SERVER_PORT=8089和SERVER_SERVLET_CONTEXT_PATH=/v2 -
JVM 系统属性:运行时传入
-Dserver.port=8089

















