spring boot修改端口和访问路径主要通过配置文件或启动参数:在application.properties中设server.port=8081和server.servlet.context-path=/api,或在application.yml中用缩进格式配置;spring boot 2.0+必须用server.servlet.context-path,废弃server.context-path;命令行可动态指定--server.port和--server.servlet.context-path。

Spring Boot 修改默认端口号和访问路径,主要靠配置文件或启动参数控制,不需改代码、不需动内嵌容器源码。核心是设置 server.port 和 server.servlet.context-path 两个属性。
在 application.properties 中配置
这是最常用、最直观的方式。确保文件位于 src/main/resources/ 目录下:
- 修改端口:添加
server.port=8081(例如改为 8081) - 修改项目根路径(即所有接口统一前缀):添加
server.servlet.context-path=/api - 完整示例:
server.port=8081 server.servlet.context-path=/api
配置后,原 http://localhost:8080/hello 就变成 http://localhost:8081/api/hello。
在 application.yml 中配置
yml 对缩进敏感,注意空格。同样放在 src/main/resources/ 下:
- 端口与路径需在同一层级,用冒号+空格分隔
- 示例:
server:
port: 8081
servlet:
context-path: /api
⚠️ 注意:Spring Boot 2.0+ 开始,server.context-path 已废弃,必须使用 server.servlet.context-path,否则无效。
启动时动态指定(临时生效)
适合调试、多实例并行或 CI/CD 场景,不改动工程配置:
- 命令行运行 jar 包时加参数:
java -jar demo.jar --server.port=8082 --server.servlet.context-path=/v2 - IDEA 中:打开 Run Configuration → 在 Program arguments 栏填入
--server.port=8082 - 也可用 JVM 参数方式(较少用):
-Dserver.port=8083
该方式优先级高于配置文件,适合快速验证或避免端口冲突(比如报错 “Port 8080 was already in use” 时可立即换端口启动)。
常见问题提醒
- 路径末尾不加斜杠,如写成
/api/可能导致重定向或 404 - context-path 值不能为
/(即空路径),设为空会回退到默认根路径,但建议显式留空或不配 - 修改后务必重启应用,配置不会热更新
- 若用 Docker 或云平台部署,还需检查宿主机端口映射或安全组是否放行新端口











