JDK 17+Spring Boot 3.x电影订票系统环境搭建与排错

简介面向具备一定 Java 基础、希望学习或从事在线票务系统开发的技术人员这份资料围绕基于 Java 与 Spring Boot 的电影在线订票选座系统展开可作为企业或创业者搭建线上票务平台的方案参考也适合课程设计与项目实战对照学习。压缩包内为 1 个 docx 文档大小约 34KB集中承载功能说明、技术选型、开发流程、核心代码示例与项目总结便于按章节查阅。内容梳理普通用户、会员和管理员三类角色的功能边界涉及电影信息浏览、选座订票、订单管理、论坛留言评论、会员折扣积分及后台用户与影视信息管理同时说明 Spring Boot、Spring Data JPA、Thymeleaf、MySQL 与 IntelliJ IDEA 在项目中的配合方式并给出注册登录、影片查询等核心代码片段、编译运行步骤和未来改进方向。已有 315 人学习适合用作订票系统设计与实现的参考资料。1. 版本先对齐JDK 17 配 Spring Boot 3.x别急着点运行把一套 Java Spring Boot 的电影在线订票系统源码拖进 IntelliJ IDEA最劝退的瞬间不是业务逻辑看不懂而是右下角依赖解析进度条转了三分钟最后满屏红色java: 无效的源发行版 17、Cannot resolve symbol springframework。我见过最典型的翻车是机器上留着 JDK 8项目 pom 里继承的却是 Spring Boot 3.x 的 parent编译期直接被拦下来——Spring Boot 3 起只认 JDK 17 及以上这条线没有商量余地。这套环境本身不复杂JDK、Maven、MySQL、一个 IntelliJ IDEA四样凑齐就能跑。难的是版本对齐和那几个配置项的取舍MySQL 8 的驱动类名跟 5.7 不是一回事Thymeleaf 模板路径差一个斜杠就是白标页。这篇笔记按我自己装机的顺序从三件套落地、IDEA 导入一路写到配置文件和排错适合手上已经有这套电影订票系统源码、想在自己机器上完整跑起来的人。2. 三件套落地JDK 17、Maven 3.9、MySQL 8.0 的安装与版本对齐装 Java 后端项目先别管代码把地基铺平。这一章按 JDK → Maven → MySQL 的顺序走每一步都给验证命令装完立刻验别攒到最后一起排查那样报错会互相掩盖很难定位到底是哪一层的问题。2.1 先装 JDK 17安装路径别带空格JAVA_HOME 指向 JDK 根目录版本选择上我一般看 pom.xml 里spring-boot-starter-parent的版本号倒推2.7.x 那条线 JDK 8 和 11 都能跑3.0 往上必须 17。原料里这套系统用的是 Spring Boot 做后端服务如果拿到的是 3.x 的工程直接上 JDK 17 的 LTS 版本最省事别去追 21部分老插件对 21 的支持还不齐。安装路径有个血泪经验不要装在C:\Program Files\Java\...这种带空格的目录下。Maven 的部分插件在拼接命令行时对空格处理不一致报错信息还特别隐晦。我一般统一放到D:\env\jdk17这种纯英文无空格路径。# Windows管理员权限的 PowerShell 里执行写系统变量 setx JAVA_HOME D:\env\jdk17 /M # 注意不要用 setx PATH %PATH%;%JAVA_HOME%\bin /M # 它会把用户 PATH 和系统 PATH 合并写死超过 1024 字符会被截断 # PATH 建议在「系统属性 → 环境变量」图形界面里手动加一条 %JAVA_HOME%\binmacOS 或 Linux 下写进~/.zshrc用系统自带的定位工具拿路径比手写死路径靠谱export JAVA_HOME$(/usr/libexec/java_home -v 17) export PATH$JAVA_HOME/bin:$PATH配完必须新开一个终端窗口再验老窗口里的环境变量是旧的java -version # 期望输出 openjdk version 17.x.x javac -version # 也必须是 17如果这里是 1.8 说明 PATH 顺序错了java -version和javac -version两个都要看只验前者是常见疏忽。有的人机器上 JRE 是 17、JDK 还是 8运行时没问题一编译就报「无效的源发行版」。另外一个高频错误是把JAVA_HOME指到了...\jdk17\bin正确做法是指到 JDK 根目录bin只出现在 PATH 里。Spring Boot 分支最低 JDK我的取舍2.7.x8只在维护老项目时用新机器不装3.0.x / 3.1.x17主流选择第三方库兼容性好3.2.x 及以上17可用注意部分依赖的传递版本提示一台机器要同时跑多个 JDK 版本时别去改全局 JAVA_HOME在 IntelliJ IDEA 的 Project Structure 里单独指定 SDK 即可全局环境保持一个稳定版本。2.2 Maven 3.9 安装本地仓库位置和镜像配置决定你等多久Maven 建议用 3.9.x 的稳定版解压即用不需要安装程序。解压到D:\env\apache-maven-3.9.x然后设MAVEN_HOMEPATH 里补%MAVEN_HOME%\bin。验证命令mvn -v # 期望同时看到 Maven 版本、Maven home 路径、Java version: 17.xmvn -v的输出里那行Java version特别关键它反映的是 Maven 实际使用的 JDK。如果这里显示 1.8 而你明明装了 17说明 JAVA_HOME 没生效或者被别的工具覆盖了后面编译一定出问题。接下来改conf/settings.xml两件事指定本地仓库位置、配一个能连通的镜像。本地仓库默认在C:\Users\你的用户名\.m2\repository用户名带中文或者磁盘空间紧张的时候我一般挪到独立盘符路径同样不能有中文和空格。settings xmlnshttp://maven.apache.org/SETTINGS/1.2.0 !-- 本地仓库挪出 C 盘路径纯英文无空格 -- localRepositoryD:/env/maven-repo/localRepository mirrors mirror idinternal-mirror/id !-- 只镜像 central别写 * 否则项目自定义的仓库也会被劫持 -- mirrorOfcentral/mirrorOf namecompany or public mirror/name !-- 换成你所在网络环境下能连通的镜像地址或内网私服别照抄这行占位 -- urlhttps://mirror.example.com/repository/public/url /mirror /mirrors /settingsmirrorOf写central而不是*是我踩过坑之后改的习惯。写*会把项目 pom 里声明的所有仓库都指向同一个地址有些工程依赖了别的仓库里的构件一旦被劫持就变成「找不到 artifact」而报错信息只会告诉你缺包不会告诉你被镜像拦了。settings.xml改完IDEA 里还要再指一次因为 IDEA 默认可能用它自己 bundle 的 Maven。这一步放在第 3 章讲先记住「命令行和 IDE 用同一套 Maven 配置」这个原则能省掉大量「命令行能打包、IDEA 里跑不起来」的玄学问题。2.3 MySQL 8.0 装完先建库建账号字符集定死在 utf8mb4数据库用 MySQL 8.0安装时选自定义路径服务名记一下。装完第一件事不是急着让 Spring Boot 连而是手动建库建账号把字符集一次性定死。字符集这个事用utf8而不是utf8mb4的话用户昵称里带 emoji 或者生僻字就会在写入时报错或者变成问号后期改表结构很麻烦。-- 建库字符集和排序规则一次到位 CREATE DATABASE movie_ticket DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_general_ci; -- 建应用专用账号不要让应用直接拿 root 连库 CREATE USER movie_applocalhost IDENTIFIED BY ChangeMe_2024; GRANT ALL PRIVILEGES ON movie_ticket.* TO movie_applocalhost; FLUSH PRIVILEGES; -- 验证character_set_ 开头的几项都应该是 utf8mb4 SHOW VARIABLES LIKE character_set_%;第三条语句FLUSH PRIVILEGES不能省改完权限不刷新应用连上来还是可能被拒。账号密码里带特殊字符的话写进配置文件时要留意转义我一般要求密码只保留字母数字加下划线省得处理引号和反斜杠。MySQL 8 还有两个绕不开的差异。一是默认认证插件是caching_sha2_password用 8.x 的驱动没问题但如果项目 pom 里引的是mysql-connector-java5.1.x 这一代老驱动连上来直接报认证失败解决办法是把驱动升到 8.x而不是去改用户的认证方式——改认证方式只是掩盖问题。二是时区容器或者某些安装方式下 MySQL 的默认时区是 UTC写进库的时间比本地时间差 8 小时连接串里必须显式带上serverTimezoneAsia/Shanghai这个参数在第 4 章的连接串里会再出现一次。3. 导入 IntelliJ IDEA从 Maven 工程识别到依赖一次拉全源码拿到手先别双击打开。正确的姿势是先在外面把目录看一遍确认它是个标准的 Maven 工程再让 IDEA 以工程的方式导入而不是直接开文件夹。这中间差一步后面要么依赖不下载要么模块识别不出来。3.1 解压后先看目录pom.xml、src/main/java、src/main/resources 三处对齐标准结构长这样包名以你源码里的实际值为准别照抄movie-ticket-system/ ├── pom.xml # Maven 的工程描述一切从这里开始 ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/movieticket/ │ │ │ ├── MovieTicketSystemApplication.java # 启动类带 SpringBootApplication │ │ │ ├── controller/ # UserController、MovieController 等 │ │ │ ├── service/ # UserService、MovieService │ │ │ ├── repository/ # UserRepository、MovieRepository │ │ │ └── entity/ # User、Movie 等实体 │ │ └── resources/ │ │ ├── application.properties # 数据库连接等配置 │ │ ├── templates/ # Thymeleaf 模板必须在这个目录下 │ │ └── static/ # css、js、图片 │ └── test/java/ └── target/ # 编译产物导入前可以删掉几个检查点启动类必须位于所有 controller、service 包的父级目录下因为SpringBootApplication默认扫描的是它自己所在包及子包。如果有人把启动类挪到了controller包里启动后接口全是 404但日志一片正常非常难查。另外templates和static两个目录名是 Spring Boot 的约定改了名就得在配置文件里补路径能不折腾就别折腾。旧工程里的target目录如果一起打包过来了先删掉里面可能是别人机器上编译的 class混淆排查视线。3.2 IDEA 里三处 JDK / Maven 设置只改一处是不够的打开 IDEA走File → Open选 pom.xml 所在目录等它识别成 Maven 工程。弹窗问是否信任项目、是否自动导入选信任和自动导入。然后有三处设置必须亲自确认少一处都可能出问题File → Project Structure → ProjectProject SDK 选 17Language level 选 17。Settings → Build, Execution, Deployment → Build Tools → MavenMaven home path 指向自己装的D:\env\apache-maven-3.9.xUser settings file 勾上 Override 指向改过的那份 settings.xmlLocal repository 会自动带出来核对一下是不是D:/env/maven-repo。同一个界面下的Maven → RunnerJRE 选 17。这一处最容易漏默认值可能是 IDEA 内置的 JRE结果就是命令行的mvn -v显示 Java 17IDEA 里跑测试却报版本不匹配。还有一处Maven → Importing里的JDK for importer也选 17。这个设置影响的是 IDEA 解析 pom 时用的 JDK配错了会在依赖解析阶段就报一堆莫名其妙的错让你以为是网络问题。改完点 Apply然后右键项目Maven → Reload project让依赖重新拉一遍。3.3 依赖拉不下来的三种情况先分清是哪一类依赖下载失败是最常见的第一道坎但原因分好几种处理方式完全不同别一上来就删本地仓库。第一种网络连不通中央仓库。表现是控制台一直重试然后超时这时候去查 2.2 节配的镜像地址通不通可以在浏览器或者curl里直接访问镜像根路径看返回。第二种本地仓库里有下载了一半的残留文件。Maven 下载中断会在本地仓库留下.lastUpdated后缀的占位文件之后不再重试。清理方式是按报错里给的路径找到目录把.lastUpdated文件删掉再重新拉。# 强制更新依赖-U 让 Maven 重新检查远程仓库的元数据 mvn -U clean dependency:resolve -DskipTests # 依赖版本冲突时用依赖树定位是哪个包带进来的 mvn dependency:tree -Dincludesorg.springframework.boot:* # 完整打包跳过测试先保证能出一个可运行的 jar mvn clean package -DskipTests-DskipTests只是跳过测试执行测试代码照样编译如果测试代码本身编译不过用-Dmaven.test.skiptrue连编译一起跳过。这两个参数的区别在赶时间的时候很有用但别养成习惯跳过编译的测试代码可能掩盖真实的编译错误。第三种是版本冲突症状通常是编译能过、启动时抛NoSuchMethodError或ClassNotFoundException。用上面的dependency:tree把包路径打出来看同一个 artifact 出现了几个版本在 pom 里用exclusions排掉传递进来的旧版本或者显式声明版本号让 Maven 的最近优先规则选你要的那个。4. 配置文件落地application.properties 每一项填什么Spring Boot 的配置项看着多这套电影订票系统真正要动的其实就那么十几个。这一章按数据源、模板引擎、建表策略三块拆开每个参数说清楚填什么、为什么这么填、改错了会看到什么现象。4.1 数据源四要素加连接池参数连接串后半段别乱删application.properties里最核心的是这一段。注意 properties 文件里不需要转义但如果哪天换成 YAML 格式是特殊字符必须给整串加引号这个差异坑过不少人。# 端口被占用时改这里别去改启动参数 server.port8080 # 连接串时区必须显式指定否则写库时间会差 8 小时 # useSSLfalse 仅限本地开发线上必须开 TLS spring.datasource.urljdbc:mysql://127.0.0.1:3306/movie_ticket?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue spring.datasource.usernamemovie_app spring.datasource.passwordChangeMe_2024 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # 连接池小项目默认值就够这里显式写出来方便调 spring.datasource.hikari.maximum-pool-size10 spring.datasource.hikari.minimum-idle2 spring.datasource.hikari.connection-timeout30000com.mysql.cj.jdbc.Driver里那个cj是 MySQL 8 驱动的标志写成老版的com.mysql.jdbc.Driver会收到一条废弃警告新版驱动甚至直接抛ClassNotFoundException。allowPublicKeyRetrievaltrue是为了兼容 8.x 默认的认证插件生产环境要配合 SSL 一起用本地开发图省事才这么写。connection-timeout单位是毫秒30000 表示 30 秒本地开发调小一点比如 5000能让连不上数据库时快速失败不用干等。至于 JPA 相关的配置# 显示 SQL本地开发开着方便对表线上关掉 spring.jpa.show-sqltrue spring.jpa.properties.hibernate.format_sqltrue # 方言MySQL 8 用这个别照抄网上 MySQL5Dialect 的老配置 spring.jpa.properties.hibernate.dialectorg.hibernate.dialect.MySQLDialect # 批量写入优化导入初始数据时能快不少 spring.jpa.properties.hibernate.jdbc.batch_size504.2 Thymeleaf 模板与静态资源前缀后缀差一个斜杠就是白标页这套系统前端用 Thymeleaf 做模板渲染默认约定是模板放在classpath:/templates/、后缀.html、静态资源放在classpath:/static/。正常情况下这些都不用配但工程迁移过来、目录被调整过的时候显式写一遍更稳。spring.thymeleaf.prefixclasspath:/templates/ spring.thymeleaf.suffix.html spring.thymeleaf.modeHTML spring.thymeleaf.encodingUTF-8 # 开发期必须关缓存否则改完模板刷新页面还是旧的 spring.thymeleaf.cachefalse # Spring Boot 2.4 之后静态资源前缀改名了老配置 spring.resources 已失效 spring.web.resources.static-locationsclasspath:/static/prefix末尾那个斜杠必须留写成classpath:/templates会导致模板拼接出来是templatesindex.html这种路径报TemplateInputException。spring.thymeleaf.cachefalse只在开发期开上线要改回 true不然每次请求都重新解析模板白白吃 CPU。静态资源那行是版本差异点Spring Boot 2.4 之前叫spring.resources.static-locations之后改成了spring.web.resources.static-locations写错了不报错只是静态资源 404页面样式全丢。4.3 建表策略ddl-auto 取什么值决定了你数据丢不丢spring.jpa.hibernate.ddl-auto这个参数是新手最容易误伤自己的地方。取值行为适用场景none什么都不做生产环境表结构由脚本管理validate只校验不一致就启动失败生产环境想早发现问题update缺表建表、缺列加列不删不改本地开发首选create每次启动删表重建只用于临时验证create-drop启动建、关闭删单元测试我自己的习惯是本地开发用update因为它只加不删不会把测试数据清掉。但update有个副作用改字段类型、改长度它不会同步时间久了本地库结构和实体类就对不上出现「明明代码里是 String库里还是 varchar(255)」这种问题。所以我会在项目稳定后切到validate逼着自己用 SQL 脚本管理表结构。# 本地开发用 update方便快速起服务 spring.jpa.hibernate.ddl-autoupdate # 首次启动成功、表结构稳定后改成 validate # spring.jpa.hibernate.ddl-autovalidate另外提一句初始数据。电影类型、系统公告这类基础数据如果源码里没带 SQL 脚本可以自己写一个data.sql放到 resources 下配合spring.sql.init.modealways在启动时执行。但要跟ddl-auto的顺序配合好data.sql执行时表得已经建好了这个顺序问题在第 5 章的排查里会具体说。5. 排查与避坑启动失败、白标页、乱码这四类翻车实录装环境的大部分时间不是花在装而是花在装完之后跑不起来。这一章记四个我遇到频率最高的场景每个都按现象、原因、解决三段写照着对号入座基本能定位。5.1 启动几秒就退出Communications link failure 与驱动类名不匹配现象控制台刷一大段堆栈最后停在com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure进程直接退出。原因分两种。第一种是数据库根本没起来或者连接串里的 host、port、库名写错最常见的是把localhost写成 127.0.0.1 之后发现 MySQL 只监听了 IPv6或者反过来。第二种是账号权限问题movie_app只授权了localhost连接串却写了127.0.0.1在 MySQL 的权限体系里这算两个不同的来源。解决先在命令行里用同一个账号手动连一次绕过应用直接验证mysql -u movie_app -p -h 127.0.0.1 -P 3306 movie_ticket。命令行能连上、应用连不上就去看连接串命令行也连不上就是账号或服务的问题。授权那一条可以把movie_applocalhost复制一份改成movie_app%或者把连接串里的 host 统一成localhost。5.2 页面显示 Whitelabel Error Page模板路径或控制器映射对不上现象接口用curl请求返回正常 JSON浏览器打开页面却是一个白底黑字的 Whitelabel Error Page状态码 500 或者 404。原因404 多半是控制器没扫描到或者请求路径对不上500 且日志里有TemplateInputException基本就是 Thymeleaf 模板路径问题。还有一种隐蔽情况模板文件放进了src/main/resources/templates没错但文件名大小写和控制器里返回的字符串不一致Windows 上不报错换到 Linux 服务器上就 404。解决先看日志里第一行Caused by那是根因。模板路径问题按 4.2 节把 prefix、suffix 显式写上末尾斜杠补全。控制器扫描不到的话回头确认启动类是不是在所有 controller 包的父级目录必要时在启动类上加ComponentScan(basePackages com.example.movieticket)显式指定。文件名大小写这个事我现在的做法是新建模板时全部小写加短横线控制器返回的字符串直接复制文件名不手打。5.3 中文乱码从数据库到页面四个地方任何一处出问题都白搭现象页面上的中文变成问号或者接口返回的 JSON 里中文是????也可能是乱码方块。原因编码链路上有四道关数据库和表的字符集、JDBC 连接串的characterEncoding、HTTP 响应的Content-Type、模板文件的文件编码。任何一处不是 UTF-8中文就会在那一环断掉。解决按链路顺序逐个查。先执行SHOW CREATE DATABASE movie_ticket;确认是utf8mb4再确认连接串里带了useUnicodetruecharacterEncodingutf8再看响应头必要时在配置文件里加server.servlet.encoding.charsetUTF-8和server.servlet.encoding.forcetrue最后确认 IDEA 里Settings → Editor → File Encodings三处都是 UTF-8包括Properties Files那一项它默认可能是 ISO-8859-1导致配置文件里的中文注释直接乱码。5.4 端口占用和「找不到主类」两个看似无关但经常一起出现的问题现象一个是Web server failed to start. Port 8080 was already in use.另一个是 IDEA 里点运行报Error: Could not find or load main class。原因端口占用通常是上一次的进程没退干净或者你同时开了两个 Spring Boot 项目。找不到主类则是编译输出目录被污染了target/classes里可能是别人的编译产物或者 Language level 和 SDK 不匹配导致 class 文件版本对不上。解决端口问题先用netstat -ano | findstr :8080Windows或lsof -i :8080macOS/Linux找到 PID确认是自己残留的进程就杀掉不想杀的改server.port。主类问题走Build → Rebuild Project还不行就mvn clean之后删掉target和 IDEA 的out目录重新编译同时复查 3.2 节那三处 JDK 设置。这套组合操作我做过很多次基本能解决九成的启动类问题。6. 跑通验证三层冒烟加一条注册链路走完才算装好服务能启动不代表装好了。我的习惯是分三层验端口在听、接口有响应、数据能落库。三层都过才算这套环境真的可用。# 第一层端口有没有在监听 netstat -ano | findstr :8080 # Windows lsof -i :8080 # macOS / Linux # 第二层读接口能不能返回 JSON注意路径末尾的斜杠要和控制器一致 curl -i http://127.0.0.1:8080/api/movies/ # 第三层写接口能不能落库注册一个冒烟账号 curl -i -X POST http://127.0.0.1:8080/api/user/register \ -H Content-Type: application/json \ -d {username:smoke01,password:Test_123456,role:USER}第一条有输出说明 Spring Boot 起来了。第二条返回 200 且 body 是电影列表的 JSON说明数据源、JPA、序列化整条链路通。第三条返回 200 且提示注册成功再去数据库里SELECT * FROM user WHERE usernamesmoke01;能查到记录说明写库正常。这里有个细节如果第三条返回 500先看日志里是不是Table movie_ticket.user doesnt exist那就是ddl-auto没生效或者实体类没加Entity如果返回 401反而是正常的说明鉴权逻辑在起作用换个已经注册的账号再试。最后我会留一份环境快照换机器或者隔几个月重装时直接照着对项我这边固定值换机先核对JDK17LTSjava -version和javac -version是否一致Maven3.9.xmvn -v里的 Java version 那行MySQL8.0字符集 utf8mb4SHOW VARIABLES LIKE character_set_%端口8080是否被其他进程占用时区Asia/Shanghai连接串里是否带serverTimezone编码UTF-8IDEA 的 File Encodings 三处从那以后我每次拿到一套 Spring Boot 源码都强制先跑java -version、mvn -v、mysql --version这三条命令再开 IDEA。看着是多余动作但能挡掉一大半「装了一下午发现是 JDK 版本不对」的情况。希望帮到你。本文还有配套的精品资源点击获取