server.port不生效需检查配置加载顺序、profile激活状态及命令行参数覆盖；context-path在Spring Boot 2.0+中改为server.servlet.context-path，必须以/开头且不以/结尾；Swagger UI路径需同步适配上下文前缀。
server.port 配置不生效？检查配置文件加载顺序和位置
Spring Boot 会按优先级从多个地方读取 server.port，最常见的是写在 application.properties 或 application.yml 里，但如果你用了 profile（比如 application-dev.properties），而启动时没加 --spring.profiles.active=dev，那默认还是走 application.properties。另外，命令行参数优先级最高，--server.port=8081 会覆盖所有配置文件里的设置。
容易踩的坑：
- IDE 运行时设置了 Program arguments 却忘了删掉旧的
--server.port=8080 - 用 Maven 打包后通过
java -jar xxx.jar启动，但配置写在了 IDE 的 Run Configuration 里，实际没生效 -
application.yml缩进错误导致server:被解析成普通 key，端口配置被忽略
推荐做法：统一用 application.yml，确保缩进正确：
server: port: 8081
context-path 是什么？别再用 server.context-path 了
Spring Boot 2.0+ 已彻底移除 server.context-path，它现在叫 server.servlet.context-path。这个改动很多人没注意，直接照搬老教程会导致路径配置完全无效——应用仍挂在根路径 /，连 /actuator 都不带前缀。
使用场景：
- 部署到 Nginx 反向代理下，需要统一加前缀如
/api - 同一台机器跑多个 Spring Boot 应用，靠路径区分
- 配合前端路由（如 Vue Router history 模式）做统一入口
注意点：
-
server.servlet.context-path必须以/开头，且不能以/结尾（比如/myapp/是错的，应写/myapp） - 配置后，所有内置 endpoint（如
/actuator/health）也会自动带上前缀，变成/myapp/actuator/health - 静态资源路径、Thymeleaf 模板中的相对链接不会自动适配，需手动处理或用
webjars+spring.mvc.static-path-pattern
运行时动态改端口或 context-path？别硬编码，用参数更稳
硬写死在配置文件里不利于多环境部署。更灵活的方式是启动时传参，尤其适合容器化场景（Docker/K8s）。
实操建议：
- 打包后用
java -jar app.jar --server.port=9090 --server.servlet.context-path=/v2 - Docker 中通过
ENV JAVA_OPTS="--server.port=9090 --server.servlet.context-path=/v2"，并在启动命令里拼接：java $JAVA_OPTS -jar app.jar - K8s 中用
args: ["--server.port=9090", "--server.servlet.context-path=/v2"]
性能影响几乎为零，但要注意：命令行参数无法覆盖 System.setProperty() 等代码中硬编码的端口设置，如果项目里有类似 System.setProperty("server.port", "8080")，得一并清理。
为什么改了 context-path，Swagger UI 找不到 /v2/api-docs？
Springfox（老版 Swagger）默认不感知 server.servlet.context-path，它生成的 API 文档路径仍是 /v2/api-docs，但实际访问地址变成了 /your-context-path/v2/api-docs，而 UI 页面里写的 base URL 还是根路径，导致 404。
解决方法取决于你用的版本：
- Springfox 3.x：加配置
springfox.documentation.swagger.v2.path=/v2/api-docs，但更推荐升级到 Springdoc OpenAPI - Springdoc OpenAPI（推荐）：它默认兼容
server.servlet.context-path，无需额外配置；如果用了自定义springdoc.api-docs.path，记得路径也要对应上下文前缀 - 若必须用老版 Springfox，可在配置类中手动 setBasePath：
docket.pathProvider(new RelativePathProvider(servletContext) { ... })
最容易被忽略的一点：Swagger UI 页面本身也受 server.servlet.context-path 影响——它的入口地址不是 /swagger-ui.html，而是 /your-context-path/swagger-ui.html，很多人卡在这一步，反复刷新根路径下的页面却一直 404。
