必须选择jdk≥17、勾选spring web依赖、用application.yml替代properties、添加@restcontroller控制器,最后运行主类并访问http://localhost:8080/hello验证。

要在IntelliJ IDEA中快速搭建可运行的Spring Boot项目,必须绕过默认生成后无法直接启动的常见陷阱,比如缺失Web依赖、JDK版本不匹配或配置文件格式不兼容。从新建项目到浏览器看到“Hello World”,全程需严格控制每一步的参数选择和后续校验动作。
创建基础项目结构
打开IDEA主界面,点击【File】→【New】→【Project】→左侧选择【Spring Boot】→点击【Next】。
在项目基本信息页填写:Project name输入demo-springboot,Location选一个不含中文和空格的路径(如D:\projects),Language选Java,Build system选Maven,JDK下拉框必须选择已安装且版本≥17的JDK(若列表为空,请先点击【Add JDK】手动指定jdk-17.0.x目录)。
点击【Next】进入依赖选择页,在左侧树形菜单展开【Web】节点,勾选【Spring Web】——这是启动内嵌Tomcat并响应HTTP请求的必要依赖,漏选会导致main方法执行后无端口监听。
确认Spring Boot版本为3.3.x系列(与JDK 17+强绑定),不要选3.2.x以下或3.4.x预发布版;点击【Create】,等待右下角Gradle/Maven进度条完成并显示“Project built successfully”。
修正关键配置文件
项目生成后,默认配置文件是application.properties,但YAML格式更易读且支持嵌套结构,必须立即替换。
在src/main/resources目录下,右键→【Delete】删除application.properties(IDEA会提示是否移至回收站,点OK)。
在同一目录右键→【New】→【File】,输入文件名application.yml(注意是字母y、m、l,不是yaml),回车后粘贴以下内容:
server:
port: 8080
spring:
application:
name: demo-springboot
使用 idealista CLI 按位置(城市、城镇、地区、街道)搜索 Idealista 房源并获取详情。适用于用户请求 Idealista 市场数据或需要 idealista‑cli 命令/标志时。
保存文件,此时IDEA底部状态栏应显示“YAML file detected”,若出现红色波浪线,检查缩进是否为两个空格且无tab字符——YAML对空白符极其敏感,用tab会导致解析失败。
添加可访问的控制器
在src/main/java/{group}/demo-springboot目录(如com.example.demo-springboot)下,右键→【New】→【Java Class】,输入类名HelloController,按回车。
在新打开的HelloController.java中,粘贴以下代码:
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
@GetMapping("/hello")
public String sayHello() {
return "Hello from Spring Boot!";
}
}
确保@RestController注解前有import语句,且@GetMapping路径以/开头;如果IDEA未自动导入org.springframework.web.bind.annotation,将光标放在注解上按Alt+Enter,选择【Add import for 'GetMapping'】。
运行并验证服务
打开项目自动生成的主启动类(通常名为DemoSpringbootApplication.java,位于同级包下),该类含@SpringBootApplication注解和main方法。
将鼠标悬停在类名左侧的绿色三角形图标上,点击弹出菜单中的【Run DemoSpringbootApplication】;或直接在编辑器中按Ctrl+Shift+F10。
观察底部【Run】工具窗口输出:当看到类似“Tomcat started on port(s): 8080”和“Started DemoSpringbootApplication in X.XXX seconds”两行日志时,说明服务已就绪。
打开浏览器,访问http://localhost:8080/hello,页面显示纯文本“Hello from Spring Boot!”即表示整个流程成功完成。










