企业官网建设流程全解析

Intellij IDEA Ultimate 使用 Maven 离线创建 Spring Boot 项目这件事，听起来像是“有网谁不会”的简单操作，但真等你坐到内网工位上，面对一个不能访问外网的开发环境，还非得把项目骨架搭起来的时候，你就会发现网上的教程要么默认你能联网，要么讲得支离破碎。我自己这几年在隔离网络、甲方内网、离线开发环境里折腾过不少次，踩过的坑攒下来一箩筐。这篇就把离线环境下用 IDEA Ultimate 配合 Maven 创建 Spring Boot 项目的完整思路、实操步骤和排错经验一次性讲透，适合正在内网做开发、或者准备离线搭建环境的朋友直接抄作业。

先明确一下这篇文章能解决什么问题：在不联网、无法访问 Maven 中央仓库、甚至连 IDEA 插件市场都连不上的环境里，怎么用 IDEA Ultimate 和 Maven 的离线模式，把一个 Spring Boot 项目从零建起来、把依赖加载出来、把启动类跑起来。整个过程不依赖任何在线服务，完全基于本地已有的 Maven 仓库和本机文件。只要你手头有一份可用的 Maven 本地仓库，或者能从另一台联网机器上拷一份仓库下来，下面这套流程基本上是“照做就能成”。

1. 为什么要离线创建 Spring Boot 项目

1.1 离线环境的典型来源

很多人觉得“离线开发”是个小众需求，但实际上遇到的场景相当多。最常见的是企业内部开发环境，安全策略要求代码和依赖都必须在内网流转，外网请求直接被防火墙拦截。其次是涉密或准涉密项目，开发机物理隔离，根本没有外网线路。还有一个容易被忽略的场景：你出差或者在客户现场，网络状况很差，IDEA 里 Maven 一直报错，这时候如果本地仓库是完整的，切到离线模式反而能舒舒服服地写代码。

不管是哪种情况，本质需求是一样的：让 Maven 和 IDEA 在完全不访问远程仓库的前提下，完成项目创建、依赖解析、编译启动这条完整链路。理解了这一点，就不会被网上那些“先下载 Spring Initializr 插件”“配置阿里云镜像”的教程带偏，因为那些方法在离线环境里根本走不通——镜像仓库也是远程仓库，离线环境连镜像也是连不上的。

1.2 离线创建和在线创建的核心差异

在线创建 Spring Boot 项目时，IDEA 会通过 Spring Initializr 服务拉取项目模板，这个服务在start.spring.io上。如果你在 IDEA 的 New Project 向导里直接选 Spring Initializr，离线环境下大概率会卡在 “Connection refused” 或者干脆长时间无响应。很多人就是在这里被卡住，觉得“没法离线建项目了”，其实只是没找对入口。

真正可靠的离线路径是：让 Maven 从本地仓库解析依赖，跳过所有远程仓库请求。项目的脚手架不是靠 Initializr 生成的，而是用 Maven 的maven-archetype插件从本地原型目录生成，或者干脆手写一个pom.xml。这两条路都不需要联网，区别只是骨架初始化的方式不同。

另外要提醒的是，IDEA 本身是有“Work offline”选项的。但如果你用的是 IDEA 内置的捆绑 Maven，它会在首次启动时尝试从远程仓库更新元数据，即使开了离线，某些插件内部行为仍然可能尝试联网。所以我的建议一直是用外部 Maven，而不是 IDEA 自带的那个。

2. 动手前准备：本地 Maven 仓库是离线的基础

2.1 Maven 本地仓库的目录结构

Maven 的本地仓库默认在用户目录下的.m2/repository，所有依赖都按groupId/artifactId/version的目录结构存放。比如spring-boot-starter-web这个依赖，路径就是org/springframework/boot/spring-boot-starter-web/2.7.18/，里面放着 jar 包、pom 文件，还有_remote.repositories和*.lastUpdated这类元数据文件。

离线环境下，_remote.repositories这个文件要特别注意。它记录了 jar 包是从哪个仓库下载的，如果里面写的仓库 ID 是central，而当前settings.xml里没有定义同名仓库，Maven 在某些严格配置下会认为依赖不可用。虽然大多数时候不影响，但稳妥起见，可以在拷贝仓库时把_remote.repositories文件删掉，让 Maven 重新识别为本地安装的依赖。

还有一个重要目录是org/apache/maven/archetypes/，这里面缓存了 Maven 的原型（archetype）模板。如果你的本地仓库里有maven-archetype-quickstart这类模板，就能用 IDEA 的 Maven 骨架功能直接生成项目雏形。这个有没有，决定了你能不能走“骨架创建”这条路。

2.2 准备离线仓库的三种办法

第一种，也是最推荐的办法：在一台能联网的机器上，先装好和离线机相同版本的 Maven，然后执行一次完整的项目构建，让本地仓库缓存所有依赖。缓存完了，把整个.m2目录打包拷贝到离线机器。注意是复制整个.m2目录，不要只复制repository文件夹，因为settings.xml也在里面，一起带上能省很多配置时间。

第二种办法，用 Maven 的dependency:go-offline插件。在联网机上进入项目目录，执行：

mvn dependency:go-offline

这个命令会把项目所有直接和传递依赖都下载到本地仓库。实测下来它比直接mvn compile更全，因为会额外拉取一些插件依赖。但如果项目里用了spring-boot-maven-plugin这类构建期插件，建议再跑一次mvn package，确保打包插件也缓存完整。

第三种办法比较朴素：手动从公司内部私服或同事的仓库里拷贝缺失的 jar。这种方式适合补漏，不适合从零搭环境。但如果你只需要跑一个很小的项目，本地仓库已经有大部分依赖，只缺个别 jar，手动拷贝反而最快。

2.3 settings.xml 的离线化配置

拿到本地仓库之后，下一步是配置settings.xml。这个文件在.m2目录下，没有的话可以自己建。离线环境下的settings.xml要做两件事：指定本地仓库路径、关闭远程仓库访问。

先说本地仓库路径。默认就是.m2/repository，一般不用改。但如果你把仓库放在 D 盘或者别的公共路径下，就要用<localRepository>显式指定：

<settings> <localRepository>D:/maven-repo/repository</localRepository> </settings>

然后是镜像配置。离线环境下，settings.xml里不应该配置任何镜像，尤其是不要配<mirror>指向*中央仓库的地址。因为开了镜像后，Maven 会把所有仓库请求都转发到镜像地址，离线情况下只会增加错误信息的迷惑性。更关键的是，不要保留任何<repository>或<pluginRepository>的在线地址，否则 Maven 启动时会尝试连接。

如果你拿到手的settings.xml是从别人那里拷来的，里面可能带着阿里云镜像或者私服地址，这里建议直接注释掉或删除。离线环境下最干净的配置就是只留<localRepository>，其他的都交给默认值。

3. 在 IDEA Ultimate 里配置 Maven 与 JDK

3.1 使用外部 Maven 而不是内嵌版本

IDEA Ultimate 安装目录下自带一个 Maven，路径一般是安装目录里的plugins/maven/lib/maven3。这个内嵌版本和你的命令行 Maven 可能版本不一致，而版本不一致在某些场景下会导致本地仓库的缓存元数据解析方式不同，表现就是“命令行能编译，IDEA 老是红”。

我的建议是：卸载依赖烦恼的最佳方式，是在 IDEA 里明确指定使用外部 Maven。进入Settings -> Build, Execution, Deployment -> Build Tools -> Maven，在 Maven home path 里选择你本机安装的 Maven 目录。这里有个细节：一定要保证外部 Maven 和命令行用的 Maven 是同一个，否则 IDEA 里 Build 用的 Maven 和你手动执行mvn用的 Maven 不一样，排查问题时会非常混乱。

同时，把User settings file指向你那份配置好的settings.xml。如果你按照第 2 节做了离线化修改，这里选择好配置文件之后，IDEA 会在下方显示配置文件的路径和本地仓库的路径，可以顺手确认一下仓库路径是否指向了你期望的目录。

3.2 配置 JDK：Project Structure 与 Settings 两个入口

离线环境里，IDEA 的自动下载 JDK 功能是废的，必须用本机已有的 JDK。这里要区分两个入口。

第一个入口是Project Structure -> SDKs。在这里点+，选择Add JDK，定位到本机 JDK 安装目录。这一步是让 IDEA 认识这个 JDK，给它起一个名字，把它加到 SDK 列表里。

第二个入口是Project Structure -> Project，把 Project SDK 设置成刚才添加的那个 JDK，同时把 Language level 设置成和 JDK 匹配的版本号。这一步是告诉 IDEA 当前项目用哪个 JDK 编译。

还有一个很多人忽略的地方：Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Importing里有一个JDK for importer选项。这个设置的是 Maven 导入项目时使用的 JDK，如果这个值不对，会导致 Maven 导入项目时反复报错或者依赖解析异常。建议把它和 Project SDK 设成同一个。

3.3 开启 Work offline 的两种方式

IDEA 里开启 Maven 离线模式有两种方式，效果相同，但适用场景略有不同。

第一种：在Settings -> Build, Execution, Deployment -> Build Tools -> Maven里勾选Work offline。勾上之后，所有 Maven 操作都不再尝试访问远程仓库。这是全局配置，一劳永逸。

第二种：在 IDEA 右侧的 Maven 工具窗口里，点工具栏上的“Maven 离线/在线切换”按钮。这个按钮在联网和离线之间切换很快，适合那种偶尔需要联网拉一下新依赖、平时又要离线的场景。但我个人在纯离线环境里更喜欢用第一种，因为第二种偶尔会因为 IDEA 缓存问题残留一些联网尝试。

需要注意，Work offline这个选项只是让 Maven 的依赖解析走本地，但项目导入时的某些插件检查仍可能触发网络请求。如果你在导入项目时发现 IDEA 卡在 “Resolving dependencies” 很久，多半就是这个原因。这时候不用慌，先让 IDEA 卡一会儿，超时之后它会自动降级到本地仓库查找，最终能导入成功。极端情况下，直接在导入前就把Work offline勾上，能减少很多等待时间。

4. 离线创建 Spring Boot 项目的三种实战姿势

4.1 方式一：手写 pom.xml + 手工建目录结构（最稳）

这是我在离线环境下最常用的方式，没有之一。离线环境最大的问题是“模板不可用”，那我们就绕开模板，自己把 Maven 项目该有的文件都写出来，IDEA 只负责导入和识别。

新建一个空白目录，比如demo，然后在里面手动创建标准 Maven 目录：

demo ├── pom.xml └── src └── main ├── java │ └── com │ └── example │ └── DemoApplication.java └── resources └── application.yml

pom.xml的内容按标准 Spring Boot 项目写，核心是继承spring-boot-starter-parent并声明 Web 启动器依赖。下面这个是 Spring Boot 2.7.18 的示例，适用于 JDK 8 到 17 的环境：

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.18</version> <relativePath/> </parent> <groupId>com.example</groupId> <artifactId>demo</artifactId> <version>0.0.1-SNAPSHOT</version> <name>demo</name> <properties> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>

写完之后，打开 IDEA，选择File -> Open，选中demo目录，IDEA 会自动识别pom.xml并作为 Maven 项目导入。前提是你在第 3 节里已经把 Maven 和 JDK 配好了。如果导入时提示 Find Usages 或者 Indexing，耐心等它跑完，只要本地仓库依赖齐全，基本不会失败。

启动类也简单，一个标准@SpringBootApplication注解就够：

package com.example; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }

这种方式的好处是“所见即所得”，每一步都可控。不管你的本地仓库是全还是半，只要pom.xml里声明的依赖在本地仓库里能找到对应版本，就能成功导入并编译。唯一的门槛是你要么记得住常用依赖的坐标，要么能在联网机器上提前把pom.xml准备好。

4.2 方式二：用 Maven 骨架（archetype）本地生成工程

如果你的本地仓库里缓存了 Maven 的 archetype 插件和常用骨架，也能在离线环境下用 IDEA 的 Maven 骨架功能生成项目。

操作路径是：File -> New -> Project -> Maven Archetype。在 Archetype 列表里，IDEA 会尝试从远程目录拉取 archetype 列表，离线时会卡住，这时候要手动点击Add Archetype，填入你本地仓库已有的骨架坐标。比如maven-archetype-quickstart的坐标是：

GroupId: org.apache.maven.archetypes ArtifactId: maven-archetype-quickstart Version: 1.1

填进去之后，IDEA 会在本地仓库查找这个骨架，如果能找到，就能正常创建项目。这个方式生成的项目默认是纯 Java 工程，不带 Spring Boot 依赖，所以骨架生成完还得自己往pom.xml里加spring-boot-starter-parent和启动类相关依赖，本质上比方式一省不了多少事。

但有一种情况我很推荐用这个方式：你本地仓库里已经缓存了某个 Spring Boot 的官方 archetype。比如spring-boot-archetype这个骨架，如果你在联网机器上用mvn archetype:generate生成过 Spring Boot 项目，本地仓库里就会留下这个骨架，那就可以直接用。否则我还是建议方式一，因为直接用 IDEA 图形界面添加 archetype 还需要手动填坐标，不如直接写pom.xml来得干脆。

4.3 方式三：联网机器生成项目离线导入

如果你不想手写pom.xml，又希望项目结构像 Spring Initializr 生成的那样规整，可以在联网机器上打开 IDEA 或直接访问 Spring Initializr 页面，生成一个项目压缩包，下载后通过 U 盘等介质拷贝到离线机器，用 IDEA 的Open功能直接打开。

这种方式的好处是项目结构、依赖版本、配置格式都是官方推荐的，省去了手写的麻烦。但要注意几个关键点：第一，生成项目时选择的 Spring Boot 版本必须是本地仓库里有的版本，否则打开后依赖照样解析不了。第二，项目如果引用了 Initializr 界面里勾选的额外依赖，比如 Lombok、MyBatis，这些依赖也要在本地仓库存在。第三，拷贝过来的项目里如果包含.mvn目录和mvnw文件，最好删掉，因为 Maven Wrapper 在离线环境下会尝试下载对应版本的 Maven，属于纯添乱。

说白了，方式三是“在别的机器上帮你生成了方式一的成品”，本质还是那套原理。我之所以把它单独列出来，是因为很多团队在离线开发前并没有意识到可以这样“借鸡下蛋”，白白在离线机上折腾半天。

5. 离线启动与运行验证

5.1 依赖加载完成之后，先验证本地仓库完整性

项目成功导入之后，IDEA 会在后台解析依赖。这个阶段不要急着写代码，先看右侧 Maven 工具窗口的 Dependencies 列表，确认所有依赖都没有红色波浪线。如果有红色，对照pom.xml里的坐标，去本地仓库路径下找那个 jar 是否存在。不存在就是仓库缺依赖，需要去联网机上补缓存再拷过来。

这里有一个非常实用的技巧：直接用 Maven 命令在 IDEA 的 Terminal 窗口里执行mvn -o clean compile。-o就是 offline 的意思，命令会强制 Maven 以离线模式编译。如果这一步能通过，说明本地仓库完全够用。如果报错，错误信息会明确告诉你缺哪个依赖、缺哪个插件，比 IDEA 图形界面里的提示准确得多。

mvn -o clean compile

我第一次离线搭建 Spring Boot 项目时，IDEA 显示依赖解析完了，但一编译就报spring-boot-maven-plugin找不到，后来用命令行一跑，错误直接指向缺失的插件目录，几分钟就定位了问题。所以，IDEA 界面显示“OK”不代表万事大吉，命令行验证才最靠谱。

5.2 启动类的编写与端口验证

启动类写好后，在 IDEA 里可以直接右键DemoApplication选择 Run。如果本地仓库的 Spring Boot 版本和 JDK 版本匹配，项目会正常启动，控制台输出 Spring Boot 的 banner，并在最后打印 Tomcat 启动端口。

这里有一个经常被问到的坑：项目启动成功但控制台没有显示端口号。这种情况多半是 Spring Boot 2.x 以上版本默认只会打印一行Tomcat started on port(s): 8080 (http)，但那是在 INFO 日志里。如果你的配置把日志级别调到了 WARN 或 ERROR，或者加了某些日志框架的配置，端口信息就会被吞掉。在application.yml里显式配一下日志级别就能解决：

logging: level: org.springframework.boot.web.embedded.tomcat: INFO

另外，如果你启动后访问http://localhost:8080发现 404，别着急，Spring Boot 项目根路径默认没有映射，这不是项目启动失败，只是没写 Controller。写一个最简单接口验证一下即可。

package com.example; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloController { @GetMapping("/hello") public String hello() { return "hello offline"; } }

5.3 常见报错排查表（离线环境专属）

离线环境下的报错有一些是共通的，我整理了一份排错速查表，基本覆盖了离线创建和运行项目时八成的问题：

这个表里我认为最值得注意的就是“命令行能过，IDEA 全红”的情况。大部分原因是你虽然换了外部 Maven，但 IDEA 会缓存以前的 Maven 索引和依赖解析结果。遇到这种情况，先把Settings -> Build Tools -> Maven里的 Work offline 关掉再打开一次，多数时候能刷新过来，还不行就把项目关掉，删除.idea目录后重新 Open，基本能解决。

5.4 内网环境 IDEA 插件与 Lombok 问题

最后补充一个容易被忽略但很要命的坑：Lombok。很多项目会用到 Lombok 来减少样板代码，但 Lombok 的正常运行需要 IDEA 里安装 Lombok 插件。离线环境下 IDEA 插件市场访问不了，没装插件的后果是：代码编译能通过（因为 Maven 的注解处理器在起作用），但 IDEA 编辑器里显示找不到getter、setter、log等符号，满屏红波浪线。

如果遇到这个问题，解决办法有两个。一个是在联网机上，从 JetBrains 插件市场下载和当前 IDEA 版本配套的 Lombok 插件 zip 包，拷贝到离线机，在Settings -> Plugins -> 齿轮图标 -> Install Plugin from Disk里离线安装。另一个是干脆不用 Lombok，把@Data、@Slf4j等注解的手动代码补齐。离线环境下我建议优先考虑后者，因为插件版本和 IDEA 版本匹配问题在离线环境下排查实在太痛苦，少依赖一个插件就少一个坑。

还有一类项目会用到 MyBatis、MyBatis-Plus，这类框架本身不依赖 IDEA 插件，只要本地仓库有对应 jar 就能正常用，但@Mapper注解在 IDEA 里如果没有装 MyBatisX 或 MyBatis 插件，不会像 Lombok 那样报符号错误，最多是没有跳转功能，不影响编译和运行。这一点可以通过 Maven 命令行编译来验证，只要mvn -o compile能过，项目就可以正常跑起来。

6. 几个值得长期保留的实战习惯

写到这里，离线的整个流程已经讲完了。最后分享几个我在多次离线环境搭建中沉淀下来的习惯，算不上什么高深技巧，但每次都能帮我省下大量时间。

第一个习惯是：在联网机器上准备仓库时，宁可多拷不要少拷。Spring Boot 项目的传递依赖非常庞杂，一个spring-boot-starter-web能牵出几十个 jar，你永远不知道哪个依赖会在后面的代码里被用到。所以，在联网机器上准备离线仓库时，最好把常用场景的依赖都提前下载一遍：Web、JPA、MyBatis、Redis、Validation、Test、Security，这些是 Spring Boot 项目里出现频率最高的依赖组合。用一个小项目把它们全部依赖一遍，执行mvn dependency:go-offline，再把整个.m2拷贝走，基本能覆盖后续大半年的开发需求。

第二个习惯是：时刻保持 Maven 版本和 IDEA 配置的一致性。离线环境排查问题本来就困难，如果 Maven 版本不一致导致行为差异，那就更麻烦了。我一般会在拿到新机器时，先把 Maven、JDK 的环境变量配好，然后确认 IDEA 的 Maven 设置指向同一个安装目录，版本号记录下来写在项目 README 里。这样不管这台机器以后谁用，都能很快定位问题。

第三个习惯是：不要过度相信“离线模式”四个字。IDEA 的Work offline生效于 Maven 依赖解析过程，但像 Maven Index 更新、插件仓库元数据检查这些动作，有时候还是会触发轻微的联网尝试。离线下最干净的做法是：把settings.xml里的镜像和远程仓库地址全部清掉，只留本地仓库路径，再从源头杜绝联网行为，这才是真正的“物理离线”。

说实话，离线创建 Spring Boot 项目这件事，说难也难，说简单也简单。难在它把在线环境下被隐藏起来的一系列细节全部暴露了出来，简单在只要你理解了 Maven 的工作原理和本地仓库的机制，在线离线其实只是参数的差别。希望这篇文章能帮你在内网环境里少走几步弯路。