Spring spring

Spring中文网站 > Spring Boot > Spring Boot项目如何启动运行 Spring Boot启动后怎么访问
Spring Boot项目如何启动运行 Spring Boot启动后怎么访问
发布时间:2026/06/30 15:35:08

品牌型号:联想ThinkPad X1

系统:Windows10家庭版

软件版本:Spring 5.3.7

很多刚接触Spring Boot的程序员往往会被它的启动方式给惊到,它不需要配置Tomcat,也不需要打war包放到容器里,一个main方法就可以直接跑起来。简单是简单,但随之而来的问题也不少,例如Spring Boot项目怎么启动才算规范?启动之后接口地址怎么访问?端口冲突了怎么办?下面就给大家介绍一下Spring Boot项目如何启动运行,Spring Boot启动后怎么访问的相关内容。

一、Spring Boot项目如何启动运行

Spring Boot项目的启动方式不止一种,开发阶段我们都是直接在IDE里跑,如果是IDEA,我们找到带Spring Boot的启动类,右键点运行或者点左边的绿色箭头,项目就起来了。控制台滚完日志、看到端口信息,说明启动成功。这种方式调试方便,开发期间基本上都是这么用的,如果有小伙伴在用Eclipse或者VS Code,操作也类似,找到启动类跑就行。

找到启动类
图1:找到启动类

除了IDE,也可以用Maven或者Gradle命令来启动。Maven项目在项目根目录下执行mvn spring-boot:run,Gradle项目执行gradle bootRun,效果跟IDE里直接跑是一样的。这种方式在不想开IDE或者需要在命令行环境下快速验证的时候比较实用。

spring-boot:run
图2:spring-boot:run

到了生产环境,通常是把项目打成可执行的jar包再部署。Maven项目执行mvn clean package,打包完成后在target目录下会生成一个jar文件,直接用java -jar命令运行这个jar包就行。Spring Boot内嵌了Tomcat,jar包本身就是完整的运行单元,服务器上只要有Java环境就能跑,不依赖外部容器,部署起来比传统war包方便很多。

项目打包
图3:项目打包

二、Spring Boot启动后怎么访问

项目启动成功之后,控制台会打出一行端口信息,默认是8080端口,这个端口就是访问的入口,地址格式是http://localhost:8080,后面拼上接口路径就能访问到对应的接口了。

默认端口是8080
图4:默认端口是8080

也有不少人访问碰到了404,大多不是项目有问题,而是路径填写错误。Spring Boot里接口路径由两部分组成,要么是@RequestMapping或者@GetMapping这类注解里写的路径,要么就是看配置文件里有没有设置context-path。

使用@PostMapping
图5:使用@PostMapping

本地开发验证接口,可以用Postman或者Apifox,把请求方式、地址、参数填进去直接发,返回结果一目了然。如果项目里集成了Swagger,启动之后访问http://localhost:8080/swagger-ui.html或者/swagger-ui/index.html,能看到所有接口的文档页面,在页面上直接调试接口也很方便,不需要额外装工具,不过现在也有不少项目用的是Knife4j,它界面更好用,访问路径是/doc.html,大概的用法基本一样。

Apifox
图6:Apifox

端口冲突是大家常见的一个问题,8080这个端口很多程序都在用,如果启动的时候报端口占用的错,在application.properties里加一行server.port=8081换个端口就行,改成其他没被占用的端口都可以。改完重启项目,访问地址里的端口号对应改一下就能正常访问了。

修改默认端口
图7:修改默认端口

以上就是Spring Boot项目如何启动运行,Spring Boot启动后怎么访问的全部内容了。Spring Boot的启动方式比较灵活,开发阶段建议大家用IDE跑比较方便,生产环境打成jar包然后用java -jar部署,简单且不依赖外部容器,启动之后的访问也不复杂,默认端口8080,路径拼对了基本上就能通了。

180 1563 6924