前言装环境这件事网上教程一抓一大把但大多停在“下一步下一步完成”装完到底对不对没人告诉你。更少有人说清楚这几款工具各自到底是干什么的、在后端里分别站在哪个位置——于是很多人装完了却说不出 Maven 和 JDK 有什么关系、Redis 为什么非装不可。本系列《从零搭建后端环境到跑通若依前后端》分为两篇BackEnd Dev 01上篇后端开发环境搭建六款核心工具安装与验收BackEnd Dev 02下篇若依框架实战从代码拉取到前后端联调跑通这篇是上篇只干一件事把JDK、Maven、MySQL、Navicat Premium、Redis、IntelliJ IDEA六款工具讲清楚、装明白、逐一验证。第一章先把六款工具的角色分工说透之后每款工具一章讲安装、配置和验证。下篇接着用这套环境拉取开源项目若依RuoYi-Vue跑通后端、手写一个业务接口、再把前端连上来。全程给出具体版本号、官方下载地址、真实报错文本和对应解法。文中的版本号、下载页面和报错文本都基于写作时2026 年 8 月的实测环境工具都在持续更新你看到的界面或输出如果和文中不一致一律以官方文档为准。一、六款工具在后端开发里各演什么角色1.1 先看全局一个请求要经过谁先别急着下载。假设后端已经跑起来了用户点了一次登录这个请求会依次经过浏览器发出 HTTP 请求 → 内嵌 Tomcat 接住 → Controller 收参数 → 查 Redis 比对验证码 → 查 MySQL 比对用户名密码 → 生成令牌写回 Redis → 返回 JSON。这条链路上出现的是JDK提供跑这段代码的 JVM、MySQL和Redis被连接的两个数据服务。而Maven和IDEA一次都没出现——它们的活儿在更早的阶段把源码变成一个能跑的 jar。至于Navicat它从头到尾都在链路外面是你自己看数据用的。所以六款工具天然分成两组构建期三件套IDEA 写代码 → Maven 拉依赖并打包 → JDK 负责编译。这三个只在打包时串起来跑一次运行期三件套JVM 跑起 jar → 连 MySQL 存数据 → 连 Redis 做缓存。这三个每次启动都要重来一遍分清这两组排错时能少走一半弯路——构建期的失败长成依赖拉不下来“编译不通过”运行期的失败长成连接被拒绝“表不存在”两类报错的排查方向完全不同。完整的协作关系如图1所示。图1 后端开发环境六款工具的分工与协作链路下面逐个说清楚每款工具是什么、在后端里干什么。1.2 JDKJava 代码的编译器与运行时JDKJava Development Kit是 Java 开发工具包里面装着三样东西javac 编译器把.java编成.class字节码、JVM 虚拟机加载并执行字节码、以及一整套核心类库和诊断工具jps、jstack、jmap这些。它在后端里的位置是最底下那一层。你写的每一行 Java 代码最终都要 javac 编译、JVM 执行Spring Boot 应用跑起来之后整个应用就是一个 JVM 进程内存怎么分配、线程怎么调度、垃圾怎么回收全归 JVM 管。有个概念得分清JRE 只能运行JDK 才能编译。JRE 里没有 javac。这就是为什么有人装完发现java -version有输出、javac -version却报错——他手上那份是 JRE或者 Path 命中了一个只转发java的目录。第二章会详细讲这个坑。1.3 Maven依赖管理与自动化构建Maven 是 Java 生态的项目管理和构建工具。核心是一个叫pom.xml的文件你在里面声明我依赖哪些库、什么版本剩下的交给它。它在后端里承担四件事依赖管理一个 Spring Boot 项目直接依赖十几个库但这些库自己还有依赖层层展开下来通常是三五百个 jar。手工下载不现实Maven 会自动解析这棵依赖树并全部拉到本地仓库统一构建mvn clean package一条命令走完清理、编译、测试、打包多模块管理若依后端由六个 Maven 模块组成父子关系和模块间依赖都写在 pom 里本地仓库复用拉下来的 jar 存在一个全局目录里所有项目共享不会每个项目下一份理解 Maven 的关键是记住它不是运行时的一部分。打包完成后 Maven 就退场了跑起来的 jar 里已经把依赖都装进去了。1.4 MySQL业务数据的最终落脚点MySQL 是关系型数据库管理系统后端里所有需要关掉电脑明天还在的数据都存在这儿——用户账号、角色权限、菜单结构、操作日志以及你后面要写的业务数据。后端应用不会自己直接开一个数据库连接就用中间还隔着一层连接池若依用的是Druid。原因是建立一次 TCP 连接加认证握手的开销不小而 Web 应用可能每秒要处理几十上百个请求。连接池的做法是提前建好一批连接放着复用用完还回来。所以你在配置文件里看到的initialSize、maxActive这些参数管的都是这批连接的数量。数据库是整条链路里最慢也最容易成为瓶颈的一环——这也正是下一节那个 Redis 存在的理由。1.5 Navicat Premium数据库的可视化操作台Navicat Premium 是图形化数据库客户端。它自己不存任何数据作用是把 MySQL 里的库、表、字段、数据用界面展示出来让你能点着鼠标建库、导脚本、看表结构、写 SQL、导出数据。开发期你和数据库打交道的动作八成会发生在这个窗口里建ry-vue库、导入若依的建表脚本、查sys_user表里初始账号、调试一条查不出结果的 SQL。命令行当然也能做但看多表关联和字段注释时图形界面效率高得多。它有个容易被忽略的性质Navicat 和 MySQL 服务端之间走的是和其他客户端完全一样的协议。这意味着协议层面的东西不兼容它就是连不上——比如 MySQL 8 默认换了认证插件老版本 Navicat 不认识就会直接报 2059。第五章会把这件事拆开讲。1.6 Redis挡在数据库前面的内存缓存Redis 是内存键值数据库。数据放在内存里读写速度比落盘的 MySQL 高出几个数量级代价是内存有限、且默认不保证绝对持久。在若依后端里它具体干三件事存登录令牌登录成功后生成的 token 存在 Redis之后每个请求都要拿 token 来这里查一次。放 Redis 而不放 MySQL是因为这个查询每个请求都要做一遍缓存字典和参数sys_dict_data、sys_config这类几乎不变但读得极频繁的数据启动时就加载进 Redis页面渲染下拉框时不必每次查库防重复提交拦截器把请求特征写进 Redis 并设过期时间短时间内的重复请求直接拒掉这里有个必须知道的事实Redis 对若依来说不是可选项是启动强依赖。没跑起来的话应用启动到一半就会失败——不是降级运行是直接起不来。这是新手最常撞的一堵墙。1.7 IntelliJ IDEA把前面五个串起来的工作台IntelliJ IDEA 是 Java 集成开发环境写代码、跳转、重构、断点调试、跑单测、直接 Run 启动类都在这里完成。它的特别之处在于上面五款工具IDEA 全都要打交道。编译时它调 JDK导入项目时它调 Maven 解析 pom调试时它连着 JVM 进程甚至内置了数据库工具能连 MySQL。也正因为这层代理关系IDEA 维护着自己的一套配置——用哪个 JDK、用哪个 Maven、读哪个settings.xml都在 IDEA 的设置里单独存着和系统环境变量是两码事。这是命令行明明能跑IDEA 里就是不行这类怪问题的根源第七章会专门对齐这三处配置。1.8 版本组合与官方下载地址角色说清楚了接下来把版本钉死。后面所有命令、配置、报错都围绕这一套展开工具本文版本选它的理由JDKEclipse Temurin 17写作时 17.0.18下篇要跑的若依 master 要求java.version是17Maven3.8.83.9 也能用3.8.x 带的那条 HTTP 拦截规则值得讲清楚MySQL8.0.x5.7 已停止官方支持新机器基本装不到Navicat Premium12 及以上11 及以下不支持caching_sha2_password连 MySQL 8 直接报 2059RedisWindows 版 5.0.14.1tporadowski 移植Redis 官方不提供 Windows 版这个移植版是本地开发的事实标准IntelliJ IDEA2023.x 及以上Community 版足够后端开发不需要任何 Ultimate 独占能力下载一律走官网。别在搜索引擎里随手点绿色版“免安装版”——那类包捆绑广告、篡改环境变量甚至塞挖矿程序的案例这些年没断过。工具官方下载地址授权与说明JDK 17https://adoptium.net/temurin/releases/开源免费。筛选 Windows / x64 /JDK/17下.msiMavenhttps://maven.apache.org/download.cgiApache 2.0。下Binary zip archive别下成 SourceMySQLhttps://dev.mysql.com/downloads/installer/Community 版免费。下载页底部有“No thanks, just start my download”不注册也能下Navicat Premiumhttps://www.navicat.com.cn/download/navicat-premium商业软件14 天试用正式使用需购买授权RedisWindowshttps://github.com/tporadowski/redis/releases第三方移植选Redis-x64-5.0.14.1.msiIntelliJ IDEAhttps://www.jetbrains.com/idea/download/页面下拉能找到Community Edition免费Ultimate 收费Git下篇拉代码用https://git-scm.com/downloads开源免费Navicat 是收费软件试用期一到就不能用。不想花钱有三个正经替代官方免费的Navicat Premium Lite、开源的DBeaver Community、MySQL 安装包自带的MySQL Workbench。破解版别碰——数据库客户端攥着你所有库的明文连接信息。1.9 安装顺序与装之前的清场顺序就是后面六章的顺序JDK → Maven → MySQL → Navicat → Redis → IDEA。理由很实在Maven 启动时要读JAVA_HOMEJDK 没配好mvn -v直接报错Navicat 是 MySQL 的客户端服务端不在没法测连接IDEA 放最后是因为它启动时会自动扫描系统里已有的 JDK 和 Maven前面都配好了IDEA 里基本不用再手动指。动手之前还有一步清干净历史残留。打开控制面板的程序和功能把以前装过的 JDK 全部卸掉然后手动检查这两个目录还在不在C:\Program Files\Java C:\Program Files\Common Files\Oracle\Java\javapath第二个目录尤其要看。它是 Oracle JDK 安装包留下的转发目录里面只有java.exe、javaw.exe、javaws.exe三个软链没有 javac.exe。而 Oracle 的安装程序会把它插到系统 Path 的最前面。下一章那个经典故障根源就在这里。二、JDK 17装好并确认真的装好了2.1 选哪个发行版Oracle JDK 下载要登录账号商用授权条款也改过好几次本地开发没必要惹这个麻烦。推荐 Eclipse Temurin原 AdoptOpenJDKAdoptium 官网直接给 Windows 的.msi双击装完事。Zulu、Corretto 也都行它们都是同一份 OpenJDK 源码构建出来的。装的时候有个选项容易漏——安装向导里有“Set JAVA_HOME variable”和“JavaSoft (Oracle) registry keys”两项默认不装。把 Set JAVA_HOME 勾上省得自己配。装完默认路径类似C:\Program Files\Eclipse Adoptium\jdk-17.0.18.7-hotspot顺带说一个和 JDK 8 时代不同的点JDK 9 之后的安装目录里没有独立的jre子目录了。所以那条流传很广的JAVA_HOME 别指到 jre的老忠告在 17 上已经不成立——但变量指错目录仍然是高频问题只是表现形式变了。2.2 环境变量JAVA_HOME 和 Path 的先后顺序如果安装时没勾自动设置就手动来。Win R输入sysdm.cpl高级 → 环境变量在系统变量里新建变量名JAVA_HOME变量值填 JDK 的安装根目录到 jdk 目录为止不要带\bin末尾也不要加分号找到Path新建一条%JAVA_HOME%\bin关键在最后一步把%JAVA_HOME%\bin用上移按钮挪到最顶上。为什么Windows 解析命令时按 Path 里目录的先后顺序从上往下逐个找撞上第一个同名可执行文件就停后面的根本不看。而 1.9 节说的那个javapath里只有java.exe、没有javac.exe——于是就出现了那个让人摸不着头脑的组合java -version正常javac -version报不是内部或外部命令。整个过程如图2所示。图2 Windows 下 java 命令的 Path 解析链路与三个变量的正确写法2.3 验证三连与 where 排查这个坑我踩过两次第二次才想明白去看 Path 顺序。排查方法很简单wherejavawhere javacwhere按命中顺序列出所有匹配路径。where java的第一行是 javapath 而不是JAVA_HOME\bin问题就找到了。改完必须新开一个 CMD 窗口——已打开的窗口拿的是旧的环境变量副本。验证java-versionjavac-versionecho%JAVA_HOME%三条都对上才算过。第三条输出应该是一个不带\bin、不带引号、不带分号的绝对路径。三、Maven 3.8.8让依赖能拉下来3.1 解压与环境变量Maven 是绿色包从官网下apache-maven-3.8.8-bin.zip解压到一个路径不带空格和中文的目录比如D:\dev\apache-maven-3.8.8。环境变量加MAVEN_HOME指向这个目录Path 里加%MAVEN_HOME%\bin。3.2 改本地仓库与阿里云镜像conf/settings.xml里有两处必改。第一处本地仓库位置。默认在C:\Users\你的用户名\.m2\repository跑几个 Spring Boot 项目就能涨到几个 G放 C 盘不合适localRepositoryD:\dev\maven-repo/localRepository第二处中央仓库镜像。不配镜像直连 Maven Central国内拉依赖极慢而且容易在下载途中断开、留下一堆.lastUpdated文件让后续构建一直失败。在mirrors节点里加mirroridaliyunmaven/idmirrorOf*/mirrorOfname阿里云公共仓库/nameurlhttps://maven.aliyun.com/repository/public/url/mirrormirrorOf*/mirrorOf表示所有仓库请求都走这里。如果项目里有私服把星号改成*,!内部仓库id。3.3 Maven 3.8.1 之后的 HTTP 拦截这条单独拎出来说因为它在网上老教程里几乎见不到。从 Maven 3.8.1 开始conf/settings.xml里默认多了一个叫maven-default-http-blocker的镜像mirroridmaven-default-http-blocker/idmirrorOfexternal:http:*/mirrorOfnamePseudo repository to mirror external repositories initially using HTTP./nameurlhttp://0.0.0.0//urlblockedtrue/blocked/mirror它会拦截所有走 HTTP非 HTTPS的外部仓库请求。有些老项目的pom.xml里写死了http://开头的仓库地址3.8.1 之前能拉之后就报blocked mirror for repositories。解法是把仓库地址改成https://而不是删掉这条拦截规则——它拦的是明文传输的依赖下载属于供应链安全防护。3.4 mvn -v一条命令验两件事mvn-v这条命令的价值被严重低估了。它的输出会同时给出Maven 版本、Maven 安装目录、它实际使用的 Java 版本和 JDK 路径Apache Maven3.8.8 Maven home: D:\dev\apache-maven-3.8.8 Java version:17.0.18, vendor: Eclipse Adoptium Java home: C:\Program Files\Eclipse Adoptium\jdk-17.0.18.7-hotspot一条命令同时验了 JDK 和 Maven 两件事。如果这里的 Java version 不是 17说明JAVA_HOME指错了或者机器上有多个 JDK 在抢 Path。四、MySQL 8.0安装向导里的两个决策点4.1 认证插件选哪个Windows 上用MySQL Installer装图形向导一路点但有两个界面必须停下来想一下。第一个是 Authentication Method。两个选项Use Strong Password Encryption默认→caching_sha2_passwordUse Legacy Authentication Method→mysql_native_password建议选默认的 Strong。老教程一律推荐选 Legacy理由是兼容性好但这个建议已经过期了mysql_native_password在MySQL 8.0.34 被标记弃用8.4 默认禁用9.0 正式移除。现在选 Legacy等于给一年后的升级埋雷。代价是有些客户端连不上具体表现和解法看第五章。另外提前规划安装路径由于 MySQL 的安装位置选项较为隐蔽通常在“Advanced Options”中且后期开发生成的 Data 数据体积可能非常庞大强烈建议在安装初期就选定空间充足的非系统盘如 D 盘或 E 盘。这样可以避免未来数据量激增导致 C 盘爆满也能省去后续迁移数据的麻烦。下面是安装过程的部分重要截图。由于安装位置的选项被隐藏你需要先点击选中程序才能看到具体的安装选择。在设置路径时如果目标文件夹已经存在安装程序会提示 “The selected path already exists”并在点击 OK 后弹出二次确认框“You still have warnings with your selected paths. Are you sure you want to continue?”。这属于正常现象只要你确认该文件夹内没有需要保留的旧数据直接点击 OK/Yes 继续安装即可程序会自动覆盖或复用该目录。4.2 字符集与 root 密码第二个决策点是字符集。8.0 默认已经是utf8mb4一般不用动如果my.ini里写的是character-set-serverutf8改成utf8mb4——MySQL 的utf8是历史遗留的三字节实现存不了 emoji 和生僻字插入会报Incorrect string value。这个默认值比想象中重要很多建表脚本并不给每张表单独指定字符集全部继承库的默认值而库又继承服务端的默认值。下篇要导的若依脚本就是这样选错了只能删库重来。安装最后一步会让你设 root 密码密码里尽量别用#%这类字符。原因在下篇改配置文件时会说到——YAML 里#后面的内容会被当成注释吃掉。4.3 命令行验证MySQL 装完Installer 不会自动把bin目录加进 Path得手动加C:\Program Files\MySQL\MySQL Server8.0\bin重开一个 CMD 窗口mysql-Vmysql-uroot-p第一条看版本号第二条输密码后能进mysql提示符就说明服务在跑、账号密码对、端口通三件事都没问题。进去后顺手确认服务端配置SHOWVARIABLESLIKEdefault_authentication_plugin;SELECTuser,host,pluginFROMmysql.user;第二条会列出每个账号实际用的认证插件。这一步是排查下一章那个 Navicat 连不上的关键证据。五、Navicat Premium连上去并看懂 20595.1 新建连接与测试Navicat 打开后新建 MySQL 连接主机localhost端口3306用户名root填密码点测试连接。弹出连接成功就过了。顺带一提连接窗口里勾了“保存密码”之后密码是明文存在配置文件里的多人共用的机器上留个心眼。5.2 报 2059 是怎么回事如果弹出的是这个2059- Authentication plugincaching_sha2_passwordcannot be loaded不用怀疑密码错了。这是客户端不支持服务端的认证插件——同一个 root 账号命令行能进、Navicat 进不去就是这个原因。三类客户端的差异如图3所示。图3 MySQL 8.0 认证插件与三类客户端的连接结果对照首选解法是把 Navicat 升到 12 以上别去改服务端。网上流传的ALTER USER ... IDENTIFIED WITH mysql_native_password确实能立刻见效但这插件正在被移除8.4 上执行直接报ERROR 1524 (HY000): Plugin mysql_native_password is not loaded。为了迁就一个老客户端去降级整库的安全策略不划算。5.3 收费与免费替代1.8 节提过 Navicat 是商业软件。如果试用期到了又不想买Navicat Premium Lite 是官方出的免费版功能精简但建库、导脚本、看表这些日常操作都够用开源阵营里DBeaver Community功能更全缺点是界面偏工程师风格、启动慢一些如果只想要个能用的MySQL 安装包里自带的MySQL Workbench也在那儿。三个都是正规渠道别去找破解版。六、Redis for Windows装哪个版本6.1 三条路怎么选Redis 官方从来不提供 Windows 版本这是很多人第一次装 Redis 时的困惑来源。Windows 上能用的实际有三条路方案说明适合tporadowski 移植版 5.0.14.1第三方移植提供.msi和绿色包装完直接是 Windows 服务本地开发本文用它WSL2 里跑官方 Linux 版Redis 官方文档现在推荐这条版本永远最新需要 5.0 之后的新特性Memurai商业产品有免费开发版企业环境要商业支持微软早年那个 3.2.100 的移植版已经停止维护多年别用了。若依用到 Redis 的地方是缓存字典、存登录令牌、防重复提交5.0 完全够用。6.2 装成 Windows 服务装.msi时勾上“Add the Redis installation folder to the PATH environment variable”安装程序会顺带把 Redis 注册成Windows 服务并设为开机自启。这比解压版省事得多。解压版每次都得手动开个 CMD 跑redis-server.exe窗口一关服务就没了——然后下次开机启动后端应用直接报错人还在纳闷我明明装了 Redis。6.3 ping 不通的三种情形验证redis-cliping返回PONG就是通的。不通的话按这三种情形对号入座报由于目标计算机积极拒绝无法连接Redis 服务没跑起来redis-cli命令本身找不到安装时没勾 PATH 那一项手动把安装目录加进 Path连上了但ping返回NOAUTH Authentication required配置里设了密码用redis-cli -a 你的密码连服务状态用这两条命令看sc query Redis net start Redis.msi安装的服务名一般就是Redis。七、IntelliJ IDEA三处配置与总验收7.1 Project SDK、Maven、编码IDEA 装完先别急着建项目。1.7 节说过它维护着自己一套配置把这三处对齐能省掉后面大量莫名其妙的问题。第一处Project SDK。File → Project Structure → ProjectSDK 选你装的那个 Temurin 17Language level 选17。这里如果留着 IDEA 自带的 JBRJetBrains Runtime编译时会出各种奇怪的兼容问题。第二处Maven。File → Settings → Build Tools → MavenMaven home path选D:\dev\apache-maven-3.8.8不要用 IDEA 内置的 Bundled MavenUser settings file勾上 Override指到你改过的那个conf/settings.xmlLocal repository会自动读出D:\dev\maven-repo如果没读出来说明上一条没指对内置 Maven 用的是它自己的settings.xml你在外面配的阿里云镜像它根本不认——“命令行 mvn 能拉下来IDEA 里就是卡在 Downloading”多半是这个原因。第三处文件编码。Settings → Editor → File Encodings把 Global Encoding、Project Encoding、Properties Files 全部设成UTF-8并勾上Transparent native-to-ascii conversion。下篇要拉的若依源码、SQL 脚本、配置文件全是 UTF-8编码不一致的直接后果是控制台日志和数据库里的中文变成问号。7.2 一个能同时验证六款工具的最小工程HelloWorld只能验 JDK 和 IDEA剩下四个还是没覆盖。花五分钟建一个 Maven 工程把六个都串一遍更实在dependenciesdependencygroupIdcom.mysql/groupIdartifactIdmysql-connector-j/artifactIdversion8.4.0/version/dependencydependencygroupIdredis.clients/groupIdartifactIdjedis/artifactIdversion5.1.0/version/dependency/dependenciespublicclassEnvCheck{publicstaticvoidmain(String[]args)throwsException{// 1) JDK能编译能运行说明 JDK 和 IDEA 都对System.out.println(JDK System.getProperty(java.version));// 2) Maven上面两个依赖能下下来说明镜像配对了// 3) MySQL驱动能加载 能建连接Class.forName(com.mysql.cj.jdbc.Driver);Stringurljdbc:mysql://localhost:3306/mysql?useSSLfalseserverTimezoneGMT%2B8;try(java.sql.Connectioncjava.sql.DriverManager.getConnection(url,root,你的密码)){System.out.println(MySQL c.getMetaData().getDatabaseProductVersion());}// 4) Redis能 ping 通try(redis.clients.jedis.Jedisjedisnewredis.clients.jedis.Jedis(localhost,6379)){System.out.println(Redis jedis.ping());}}}跑通之后控制台会依次打出 JDK 版本、MySQL 版本和PONG。六款工具里只剩 Navicat 没覆盖它本来就是图形工具第五章测过连接就够了。这一步的意义在于它把六个工具各自装好变成了六个工具能协同工作。下篇若依起不来时你至少能确定不是环境的问题。7.3 环境验收清单最后把六项验证汇总成一张表从上到下走一遍全绿了才算装完如图4所示。图4 六款工具的环境验收面板与常见失败原因工具验证方式期望结果常见失败与原因JDKjava -version/javac -versionopenjdk version 17.0.18/javac 17.0.18报不是内部或外部命令 Path 里 javapath 排在前面Mavenmvn -v同时显示 Maven 3.8.8 与 Java 17.0.18报JAVA_HOME not found 变量名拼错或路径写错MySQLmysql -u root -p进入mysql提示符Access denied 密码错Cant connect 服务没启动Navicat新建连接 → 测试连接弹出连接成功2059 客户端太老不支持 caching_sha2_passwordRedisredis-cli后输入ping返回PONG目标计算机积极拒绝 Redis 服务没跑IDEA运行EnvCheck.main()依次打印 JDK / MySQL / PONG卡在 Downloading 用了内置 Bundled Maven八、注意事项一、改完环境变量不重开窗口。CMD、PowerShell、IDEA 在启动时把环境变量拷贝了一份之后系统里怎么改都跟它无关。改完 Path 一定要新开窗口如果是给 IDEA 用得把 IDEA 整个重启不是关掉项目重开。二、机器上同时装了多个 JDK。这是mvn -v显示的版本和你以为的不一致的根源。where java看命中顺序echo %JAVA_HOME%看变量指向对不上就改 Path 顺序。三、Maven 拉依赖中断留下的.lastUpdated文件。Maven 看到它就认为最近试过了暂时别再试于是构建一直失败报的还是Could not resolve dependencies。删掉即可del /s /qD:\dev\maven-repo\*.lastUpdated或者构建时加-U强制更新mvn clean package -U。四、时区问题不止连接串一处。JDBC 连接串里的serverTimezoneGMT%2B8只管驱动侧。如果查出来的时间还差 8 小时去看服务端SHOWVARIABLESLIKE%time_zone%;SETGLOBALtime_zone8:00;要永久生效得写进my.ini的[mysqld]段default-time-zone8:00然后重启服务。五、Redis 装成解压版又忘了启动。这是下篇最高频的应用起不来原因。装.msi注册成服务能一劳永逸已经用了解压版的话把redis-server.exe --service-install补上。六、端口被占。MySQL 的 3306、Redis 的 6379 都可能被别的软件占着。查占用netstat-ano|findstr :3306 taskkill /F /PID 查到的进程号七、IDEA 用了内置 Maven 导致镜像不生效。7.1 节说过这里再强调一次因为表现太迷惑命令行三分钟跑完IDEA 里同一个项目卡在 Downloading 半小时。去检查Settings → Build Tools → Maven那三项。八、这篇文章会过期官方文档不会。六款工具都在持续更新Adoptium 每季度发新版本MySQL 关于认证插件的策略一路在收紧Navicat 和 IDEA 的界面几乎每个大版本都调。文中的版本号、菜单路径都请当成写作时的快照真正的判断依据永远是各工具官网的 Release Notes 和文档。另外文中第三方工具各有各的授权条款Navicat 商用需购买、IDEA Ultimate 收费请按各自官网的许可协议使用。九、本文总结回头看这套环境真正的分水岭有三处。第一处是搞清楚每款工具站在哪儿。构建期的 IDEA、Maven、JDK 只在打包时串一次运行期的 JVM、MySQL、Redis 每次启动都要重连Navicat 全程在链路外面。分清这两组出问题时就知道该往哪个方向查——依赖拉不下来和连接被拒绝根本不是一类问题。第二处是 Path 的先后顺序。Windows 的命令解析是先命中先赢JDK 装了、变量也设了只要javapath排在%JAVA_HOME%\bin前面javac就用不了。养成用where 命令名排查的习惯比反复重装有用得多。第三处是验证这件事本身。装完点个完成不叫装好每一款工具都得有一条能跑出确定输出的命令。第七章那个最小工程的价值就是把各自装好变成能协同工作。环境这一层做扎实后面所有问题都能少一半排查路径——因为你可以确信不是环境的锅。十、更多操作下篇预告。这套环境搭好之后下一步就是拿它跑一个真实项目。**下篇《若依实战从拉取代码到跑通前后端》**会接着讲若依这个开源脚手架到底替你做完了哪些事产品线和分支怎么选为什么有人用 JDK 8 跑最新版会报无效的源发行版: 17两层机制拆开讲拉代码、建库导脚本、改配置、启动五道关卡各自的失败特征在它的数据库上加自己的业务表以及手写一个业务接口要新建哪四个文件前端RuoYi-Vue3怎么单独拉取、启动并连上你本地这个后端关于本专栏。如果这篇对你有用欢迎关注本专栏《后端开发实战笔记》。这个专栏不写泛泛的科普只写能照着做出来、能避开坑的实战内容确切的版本号、可复制的命令、真实的报错文本以及为什么会这样的机制解释——而不是让你抄段配置进去然后祈祷它能跑。内容方向大致是这几块环境与工具链Windows / Linux 下的 Java 环境搭建、Docker 化改造、多版本 JDK 共存与切换若依二次开发数据权限怎么落到 SQL、代码生成器模板怎么改、多数据源、文件上传与对象存储对接Spring Boot 进阶从 2.x 升到 3.x/4.x 的真实迁移记录、javax到jakarta的踩坑清单数据库与中间件MySQL 索引与慢 SQL 优化、Redis 缓存穿透与雪崩的工程处理等等有问题欢迎评论区留言尤其是文中哪一步在你机器上没跑通——这类反馈会直接补进后续修订。