阿里云 on Liangweidong's blog

阿里云 ECS 云盘挂载：分区、扩容与开机自动挂载实战

Mon, 15 Sep 2025 00:00:00 +0800

一、为什么 2025 年还要手挂云盘

阿里云 ECS 默认只给系统盘（/dev/vda），数据盘（/dev/vdb、/dev/vdc…）是单独购买的。买完数据盘后必须：

给云盘分区
格式化文件系统
挂载到 ECS 的某个目录
写进 /etc/fstab 开机自动挂载

否则重启就丢挂载点，数据盘变成了"挂在那儿但没用的盘"。

本文写于 2025-09-15。覆盖 2T 以下（MBR）、2T+（GPT）、原盘扩容三种场景。CentOS 7+ / Ubuntu 18.04+ / Debian 10+ / Anolis OS 8 通用。

二、查云盘

1

fdisk -l

典型输出（ECS 默认 1 块系统盘 + 2 块数据盘）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


Disk /dev/vda: 20 GiB, 21474836480 bytes, 41943040 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0xe4c1f796

Device Boot Start End Sectors Size Id Type
/dev/vda1 * 2048 41940991 41938944 20G 83 Linux


Disk /dev/vdb: 100 GiB, 107374182400 bytes, 209715200 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes


Disk /dev/vdc: 500 GiB, 536870912000 bytes, 1048576000 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes

坑提醒：看到 Disk /dev/vdX doesn't contain a valid partition table 是正常的——新数据盘没分区。

三、场景一：全新数据盘挂载

3.1 一个目录只能挂一个盘

挂载前先想清楚目录——一个目录只能挂一个盘，挂第二个会覆盖第一个。常见目录：

/data：通用数据盘
/var/lib/docker：Docker 专用
/home：用户家目录
/mnt/<业务名>：业务专用

3.2 2T 以下：MBR 分区（fdisk）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


fdisk -u /dev/vdc
# 输入：
# p 查看
# n 新建
# p 主分区
# 1 分区号
# 回车 默认起始扇区（2048）
# 回车 默认结束扇区（整盘）
# wq 写并退出

fdisk -lu /dev/vdc
# 确认新分区 /dev/vdc1

3.3 2T+ ：GPT 分区（parted）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


yum install -y parted e2fsprogs
# Debian/Ubuntu
# apt install -y parted e2fsprogs

parted /dev/vdb
# 在 parted 交互里：
# mklabel gpt # 设置 GPT 分区表
# mkpart primary 1 100% # 划分一个主分区占满整盘
# align-check optimal 1 # 检查对齐（aligned 说明对齐）
# print # 看分区表
# quit # 退出

partprobe # 让内核重读分区表
fdisk -lu /dev/vdb

3.4 格式化文件系统

1
2
3
4
5


# ext4（最常用，CentOS 7+ 默认）
mkfs -t ext4 /dev/vdc1

# xfs（CentOS 7+ 默认系统盘格式，大文件更优）
mkfs.xfs /dev/vdc1

3.5 挂载

1
2
3
4
5


mkdir -p /data
mount /dev/vdc1 /data
df -h
# Filesystem Size Used Avail Use% Mounted on
# /dev/vdc1 500G 73M 500G 1% /data

3.6 写进 /etc/fstab（开机自动挂载）

关键：用 blkid 拿 UUID，而不是直接写 /dev/vdc1——云盘 ID 在重启时可能变化。

1
2
3


# 查 UUID
blkid /dev/vdc1
# /dev/vdc1: UUID="a6ce082e-88cb-469f-8405-72192b89a439" TYPE="ext4"

手动写 /etc/fstab：

1
2
3
4
5


# 备份
cp /etc/fstab /etc/fstab.bak

# 写入（用 echo 追加）
echo `blkid /dev/vdc1 | awk '{print $2}' | sed 's/\"//g'` /data ext4 defaults 0 0 >> /etc/fstab

或者用 UUID 字符串直接写：

1

UUID=a6ce082e-88cb-469f-8405-72192b89a439 /data ext4 defaults 0 0

/etc/fstab 完整示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# /etc/fstab: static file system information.
#
# Use 'blkid' to print the universally unique identifier for a
# device; this may be used with UUID= as a more robust way to name devices
# that works even if disks are added and removed. See fstab(5).
#
# <file system> <mount point> <type> <options> <dump> <pass>
# / was on /dev/vda1 during installation
UUID=f126eb90-41ef-4ccf-afa2-055203ed920e / ext4 errors=remount-ro 0 1
/dev/sr0 /media/cdrom0 udf,iso9660 user,noauto 0 0
/home ext4 defaults 0 0
UUID=a6ce082e-88cb-469f-8405-72192b89a439 /data ext4 defaults 0 0

字段含义：

字段	含义
`<file system>`	设备 / UUID
`<mount point>`	挂载点
`<type>`	文件系统（ext4 / xfs / swap）
`<options>`	挂载选项（`defaults` / `noatime` / `nodev`）
`<dump>`	是否被 `dump` 备份（0 = 不备份）
`<pass>`	`fsck` 检查顺序（0 = 不检查，1 = 根，2 = 其他）

3.7 验证

1
2


mount -a # 模拟重启挂载（不重启）
df -h

坑提醒：/etc/fstab 写错会导致 ECS 启动失败。改完一定先 mount -a 验证，能正常挂再重启。

四、场景二：把根目录挂到数据盘（一般不要）

centos7.md 等老文档会演示"扩展 /"，操作极其危险——需要动 LVM。本节给出标准流程，新机器不要这么干，直接买大系统盘。

4.1 终止占用 /home 进程

1

fuser -m -v -i -k /home

4.2 备份 /home

1

cp -r /home/ homebak/

4.3 卸载 /home + 删 lv

1
2


umount /home
lvremove /dev/mapper/centos-home

4.4 扩展 /root lv

1
2
3
4


lvextend -L +100G /dev/mapper/centos-root
xfs_growfs /dev/mapper/centos-root
# ext4 用 resize2fs
# resize2fs /dev/mapper/centos-root

4.5 重建 home

1
2
3
4
5


lvcreate -L 40G -n home centos
mkfs.xfs /dev/centos/home
mount /dev/centos/home /home
cp -r homebak/* /home/
chown -R <user>:<group> /home/<user>

强烈不推荐——中间任何一步失败都会让系统无法启动。新机器直接买大系统盘更省事。

五、场景三：原盘扩容

需求：原来是 500G 数据盘不够用，在阿里云控制台扩容到 700G，数据不变、挂载不变。

5.1 控制台扩容

ECS 控制台 → 云盘 → 更多 → 磁盘扩容 → 改容量 → 重启（必须重启才能识别新容量）。

5.2 删旧分区 + 建新分区

1
2
3
4
5
6
7
8
9


fdisk /dev/vdb
# 输入：
# d 删除分区
# n 新建分区
# p 主分区
# 1 分区号
# 回车 回车 默认起止
# 提示 "Partition #1 contains a ext4 signature" → 输入 n（不删除签名）
# w 保存退出

5.3 修正文件系统

1
2
3


resize2fs /dev/vdb1
df -h
# 看到 700G 就对了

坑提醒：xfs 文件系统不支持 resize2fs 缩容（只能扩容），用 xfs_growfs：

1

xfs_growfs /data

六、典型坑速查

现象	原因	处理
`fdisk` 提示 “Partition table entries are not in disk order”	多次增删分区后	走 §5 重建
`mount /dev/vdc1 /data` 报 “wrong fs type”	没格式化	走 §3.4 `mkfs`
`blkid` 拿不到 UUID	内核没识别新分区	`partprobe` 强制重读
重启后挂载点丢了	没写 `/etc/fstab`	走 §3.6
`/etc/fstab` 写错导致 ECS 起不来	字段不对	进救援模式（控制台 → 救援连接）改回
`The device apparently does not exist`	内核没重读分区	`partprobe`
扩容后 `df -h` 还是原大小	文件系统没扩	走 §5.3 `resize2fs` / `xfs_growfs`

七、开机自动挂载的最佳实践

7.1 用 UUID 而不是设备名

/dev/vdX 在重启时可能变化（内核按发现顺序命名），UUID 是稳定的。

7.2 加 nofail 选项（云盘场景）

1

UUID=a6ce082e-88cb-469f-8405-72192b89a439 /data ext4 defaults,nofail 0 0

nofail 告诉 systemd：挂载失败也别停机——适合云盘还没挂的过渡期。

7.3 配 fsck 顺序

/：pass = 1（先检查）
其他：pass = 2（后检查）
swap：pass = 0（不检查）

八、典型用法速查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查所有块设备
lsblk

# 查 UUID
blkid

# 查挂载点
df -h
mount | column -t

# 查 /etc/fstab
cat /etc/fstab

# 手动 mount
mount -a # 模拟重启挂载
mount -o remount,rw /data # 重新挂载（改可写）
mount -o noatime /dev/vdc1 /data # 不更新访问时间（提升 IO 性能）

# 卸载
umount /data

九、下一步

想做云盘快照 + 跨区复制 → 走阿里云 ESSD / SSD 云盘 + 快照服务
想做多盘合并（JBOD / RAID0）→ 用 mdadm 或 LVM
想做云盘监控 → 阿里云 云监控 → 配磁盘使用率 / IOPS 告警
想换更现代的存储方案 → 阿里云 NAS（共享文件存储）/ OSS（对象存储）

参考资料

2024+ 视角：写于 2025-09，半年后阿里云 ESSD 与云原生存储

本文写于 2025-09-15——半年后（2026 年）阿里云存储领域又发生了几件值得关注的事。

一、ESSD 已成"默认云盘"（2020+ 趋势的延续）

2025 年阿里云新购 ECS 默认云盘已经是 ESSD Entry / ESSD PL0 / PL1，普通 SSD 云盘逐渐淘汰。
ESSD PL3 / PL4（2024 起推出）：
- 单盘 IOPS 最高 100 万，吞吐量 4 GB/s——直逼本地 NVMe SSD。
- 适合数据库（MySQL / Redis / MongoDB）的高并发场景。

1
2
3
4
5
6


# 2025 看云盘类型
fdisk -l
# Disk /dev/vdb: 500 GiB, 536870912000 bytes, 1048576000 sectors
# 看不到"是 ESSD PL1 还是 PL3"——要去控制台 / OpenAPI 看：
aliyun ecs DescribeDisks --DiskId d-bp1xxxxxxxxxxxxxx | jq '.Disks.Disk[0].Category'
# "cloud_essd" / "cloud_essd_entry" / "cloud_essd_pl1" ...

二、在线扩容的"无重启"姿势

2017 之前：扩容云盘必须重启 ECS。
2021+：阿里云支持在线扩容（不重启），但需要 OS 层配合：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 1. 阿里云控制台扩容（无需重启）
# 2. 查新容量
fdisk -l /dev/vdb

# 3. 重建分区表
partprobe /dev/vdb
growpart /dev/vdb 1 # cloud-utils-growpart 包

# 4. 文件系统扩容
xfs_growfs /data # xfs
# resize2fs /dev/vdb1 # ext4 自动检测新大小

前提：分区是 GPT 才有 growpart 的"自由空间"概念（MBR 4 个主分区限制）。

三、云盘快照 + 跨区复制

快照 2.0（2023 起）：增量化、秒级创建。
跨区复制：通过 快照一致性组 + CRC 校验 + 加密传输——异地灾备 5 分钟搞定。

1
2
3
4
5
6


# 用 OpenAPI 创建加密跨区快照
aliyun ecs CopyImage \
 --RegionId cn-hangzhou \
 --ImageId m-bp1xxxxxxxxxxxxxx \
 --DestinationRegionId cn-shanghai \
 --Encrypted true

四、Ultra Disk / 本地盘 SSD 的回归

2020-2023：本地盘被云盘（ESSD）压制。
2024-2025：AI 训练 / 大模型推理对超低延迟本地 NVMe SSD 需求回升——阿里云推出 d3 / d3c（高 IO 本地盘）+ ea（本地 NVMe SSD）。

类型	延迟	IOPS	吞吐	适用
ESSD PL1	1-2 ms	5 万	350 MB/s	通用数据库
ESSD PL3	< 1 ms	100 万	4 GB/s	高并发数据库
本地 NVMe SSD（d3c）	100-200 μs	100 万+	5+ GB/s	AI 训练 / Redis

五、NAS / OSS / 块存储的"三分天下"

块存储（云盘）：单 ECS 独占，数据库专用。
NAS（NFS / SMB）：多 ECS 共享，Web 静态资源 / 容器 PVC。
OSS（对象存储）：无限容量，备份 / 日志归档 / 静态网站托管。

2024+ 新选择：

阿里云 ECI（Elastic Container Instance）：直接跑容器，不需要 ECS——容器数据存 ESSD 或 NAS。
CPFS（并行文件系统）：AI / HPC 场景专用，PB 级吞吐。
OSS 加速器（transfer acceleration）：跨境传输 10x 加速。

六、UltraPath / 多路径 IO

多块云盘做 RAID 0 / 1 / 10 时，2024 阿里云推荐用 UltraPath 替代 mdadm：

1
2
3
4


# 装 UltraPath Agent
wget https://alibaba-ultra-path.oss-cn-hangzhou.aliyuncs.com/ultrapath-linux-<version>.rpm
rpm -ivh ultrapath-linux-<version>.rpm
upadmin show path

优势：自动识别云盘拓扑、IO 调度优化、故障路径切换（< 5s）。

七、fstab 写错导致 ECS 起不来的"无救援模式恢复"

2017 那篇给的是"控制台 VNC → 改 fstab"。
2024 起：阿里云提供 “实例救援连接”——通过 VNC 但更稳定（基于 IPMI）：

1
2
3
4
5
6


# 控制台 → ECS → 实例 → 远程连接 → 救援连接
# 等几分钟后，自动进 single user mode
mount -o remount,rw /
vi /etc/fstab
# 改回正确配置
reboot

预防：fstab 写错之前用 mount -a 验证（本文 §3.7 已强调）。

八、/etc/fstab “nofail” 选项的 2024 最佳实践

本文 §7.2 已经强调 nofail。2024 进阶：

1

UUID=xxx /data ext4 defaults,nofail,nobootwait,x-systemd.device-timeout=30 0 2

选项	作用
`nofail`	挂载失败不阻塞启动
`nobootwait`	不等待挂载（systemd 早期兼容）
`x-systemd.device-timeout=30`	设备等待 30 秒（默认 90 秒太慢）
`x-systemd.requires=`	挂载前等某个 unit

2024 推荐写法：

1
2


# /etc/fstab
UUID=a6ce082e-... /data ext4 defaults,nofail,x-systemd.device-timeout=10 0 2

九、云原生时代的"挂载"

2024 大量新应用不直接挂云盘——走 CSI 驱动 + PV/PVC（K8s）。
阿里云 CSI 插件自动把 ESSD 映射为 Pod 的 volume：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


apiVersion: v1
kind: PersistentVolumeClaim
metadata:
 name: mysql-data
spec:
 accessModes:
 - ReadWriteOnce
 resources:
 requests:
 storage: 500Gi
 storageClassName: alicloud-disk-essd

1
2
3


kubectl get pvc
# STATUS: Bound
# VOLUME: d-bp1xxxxxxxxxxxxxx

优势：Pod 漂移到其他节点自动重新挂载，不再关心 fstab / UUID。

Maven 全套实战：从安装到多模块企业级构建

Thu, 20 Feb 2014 00:00:00 +0800

Maven 全套实战：从安装到多模块企业级构建

背景与价值

Maven 是 Java 生态事实标准构建工具（Ant 已老、Gradle 学习成本高）。核心价值：

依赖管理：自动下载 jar 及其传递依赖，避免版本冲突
标准化结构：src/main/java、src/test/java 等约定优于配置
多模块管理：父子 POM 继承 + dependencyManagement 统一版本
构建生命周期：compile / test / package / install / deploy 一键式

本文按"安装 → 核心配置 → 多模块 → 实战坑"完整路径展开，基于 Maven 3.9.x 实测。

安装与配置

1. 下载解压

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# Linux
curl -O https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
mkdir -p /opt/maven
tar -zxvf apache-maven-3.9.6-bin.tar.gz -C /opt/maven

# 配置环境变量
export JAVA_HOME=/opt/java/jdk1.8.0_381
export MAVEN_HOME=/opt/maven
export PATH=.:$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$MAVEN_HOME/bin:$PATH

# 验证
mvn -version
# Apache Maven 3.9.6 (8c8575b0e1b8...)
# Java version: 1.8.0_381

2. 全局配置文件 `${maven_home}/conf/settings.xml`

settings.xml 集中管理仓库镜像、代理、profile、服务器认证等全局配置，避免每个项目单独配。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56


<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0">

 <!-- 本地仓库路径（默认 ${user.home}/.m2/repository） -->
 <!--<localRepository>/path/to/local/repo</localRepository>-->

 <!-- 离线模式（无法联网时） -->
 <!--<offline>false</offline>-->

 <!-- 代理（公司内网访问外网 Maven 中央仓库时） -->
 <proxies>
 <proxy>
 <id>myproxy</id>
 <active>true</active>
 <protocol>http</protocol>
 <host>proxy.example.com</host>
 <port>8080</port>
 <username>proxyuser</username>
 <password>{{PROXY_PASSWORD}}</password>
 <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
 </proxy>
 </proxies>

 <!-- 服务器认证（部署到 Nexus / 私库时用） -->
 <servers>
 <server>
 <id>nexus-releases</id>
 <username>{{NEXUS_USER}}</username>
 <password>{{NEXUS_PASSWORD}}</password>
 </server>
 </servers>

 <!-- 镜像（关键：阿里云加速国内下载） -->
 <mirrors>
 <mirror>
 <id>aliyun-public</id>
 <name>阿里云 Maven 公共仓库</name>
 <url>https://maven.aliyun.com/repository/public</url>
 <mirrorOf>central</mirrorOf>
 </mirror>
 </mirrors>

 <!-- 多环境 Profile -->
 <profiles>
 <profile>
 <id>jdk-1.8</id>
 <activation>
 <activeByDefault>true</activeByDefault>
 </activation>
 <properties>
 <maven.compiler.source>1.8</maven.compiler.source>
 <maven.compiler.target>1.8</maven.compiler.target>
 </properties>
 </profile>
 </profiles>
</settings>

3. 阿里云镜像配置（关键）

国内访问 Maven 中央仓库（repo1.maven.org）经常超时，建议配置阿里云镜像：

仓库类型	阿里云地址
公共仓库	`https://maven.aliyun.com/repository/public`
Google	`https://maven.aliyun.com/repository/google`
Spring	`https://maven.aliyun.com/repository/spring`
Apache Snapshots	`https://maven.aliyun.com/repository/apache-snapshots`

配置示例（settings.xml 镜像）：

1
2
3
4
5
6


<mirror>
 <id>aliyun-spring</id>
 <name>阿里云 Spring 仓库</name>
 <url>https://maven.aliyun.com/repository/spring</url>
 <mirrorOf>spring-milestones,spring-snapshots</mirrorOf>
</mirror>

核心概念

1. 坐标（GAV）

每个 Maven 构件由三要素唯一定位：

1
2
3
4
5


<dependency>
 <groupId>org.springframework.boot</groupId> <!-- 组织 -->
 <artifactId>spring-boot-starter-web</artifactId> <!-- 项目 -->
 <version>3.2.0</version> <!-- 版本 -->
</dependency>

2. 仓库类型

类型	位置	用途
本地仓库	`~/.m2/repository/`	已下载的依赖
中央仓库	`repo1.maven.org`	Maven 官方仓库（默认）
私服	Nexus / Artifactory	公司内网，缓存 + 部署
镜像仓库	阿里云 / 华为云	中央仓库的国内镜像

3. 依赖范围（Scope）

Scope	编译	测试	运行时	例子
`compile`（默认）	✅	✅	✅	`spring-core`
`provided`	✅	✅	❌	`servlet-api`（容器提供）
`runtime`	❌	✅	✅	`JDBC 驱动`
`test`	❌	✅	❌	`JUnit`
`system`	✅	✅	❌	引用本地 jar（不推荐）

4. 生命周期阶段

1
2
3
4
5
6


mvn clean # 清理 target/
mvn compile # 编译 main
mvn test # 编译并运行测试
mvn package # 打包成 jar/war
mvn install # 安装到本地仓库（供其他模块引用）
mvn deploy # 部署到远程私服

多模块项目（企业级核心）

1. 父 POM 约定

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


my-project/ # 父项目根目录
├── pom.xml # 父 POM（packaging=pom）
├── my-app/ # 主应用模块
│ ├── pom.xml
│ └── src/
├── my-common/ # 公共工具模块
│ ├── pom.xml
│ └── src/
└── my-api/ # API 定义模块
 ├── pom.xml
 └── src/

2. 父 POM 完整模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
 <modelVersion>4.0.0</modelVersion>

 <!-- 继承 Spring Boot Starter Parent（统一版本管理） -->
 <parent>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-parent</artifactId>
 <version>2.6.14</version>
 <relativePath/>
 </parent>

 <groupId>com.example</groupId>
 <artifactId>my-project</artifactId>
 <version>1.0.0-SNAPSHOT</version>
 <packaging>pom</packaging>
 <name>my-project</name>

 <!-- 子模块清单 -->
 <modules>
 <module>my-common</module>
 <module>my-api</module>
 <module>my-app</module>
 </modules>

 <!-- 统一版本管理（子模块引用时不需要写版本号） -->
 <dependencyManagement>
 <dependencies>
 <!-- Spring Cloud -->
 <dependency>
 <groupId>org.springframework.cloud</groupId>
 <artifactId>spring-cloud-dependencies</artifactId>
 <version>${spring-cloud.version}</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 <!-- Spring Cloud Alibaba -->
 <dependency>
 <groupId>com.alibaba.cloud</groupId>
 <artifactId>spring-cloud-alibaba-dependencies</artifactId>
 <version>${spring-cloud-alibaba.version}</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 <!-- 项目内部模块 -->
 <dependency>
 <groupId>com.example</groupId>
 <artifactId>my-common</artifactId>
 <version>${project.version}</version>
 </dependency>
 </dependencies>
 </dependencyManagement>

 <!-- 公共依赖（所有子模块都会继承） -->
 <dependencies>
 <dependency>
 <groupId>org.projectlombok</groupId>
 <artifactId>lombok</artifactId>
 <scope>provided</scope>
 </dependency>
 </dependencies>

 <!-- 统一属性 -->
 <properties>
 <java.version>1.8</java.version>
 <maven.compiler.source>${java.version}</maven.compiler.source>
 <maven.compiler.target>${java.version}</maven.compiler.target>
 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 <spring-cloud.version>2021.0.1</spring-cloud.version>
 <spring-cloud-alibaba.version>2021.0.1.0</spring-cloud-alibaba.version>
 </properties>

 <!-- 多环境 Profile -->
 <profiles>
 <profile>
 <id>dev</id>
 <activation>
 <activeByDefault>true</activeByDefault>
 </activation>
 <properties>
 <profile.name>dev</profile.name>
 </properties>
 </profile>
 <profile>
 <id>test</id>
 <properties>
 <profile.name>test</profile.name>
 </properties>
 </profile>
 <profile>
 <id>prod</id>
 <properties>
 <profile.name>prod</profile.name>
 </properties>
 </profile>
 </profiles>
</project>

3. 子模块 POM

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


<?xml version="1.0" encoding="UTF-8"?>
<project>
 <parent>
 <groupId>com.example</groupId>
 <artifactId>my-project</artifactId>
 <version>1.0.0-SNAPSHOT</version>
 </parent>

 <artifactId>my-app</artifactId>
 <packaging>jar</packaging>

 <!-- 不需要写版本号（父 dependencyManagement 已管理） -->
 <dependencies>
 <dependency>
 <groupId>com.example</groupId>
 <artifactId>my-common</artifactId>
 </dependency>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
 </dependency>
 </dependencies>
</project>

常用命令

命令	作用
`mvn clean`	清理 target 目录
`mvn compile`	编译主代码
`mvn test`	运行单元测试
`mvn package -DskipTests`	打包跳过测试
`mvn dependency:tree`	树形展示依赖
`mvn dependency:tree -Dincludes=commons-logging`	过滤特定依赖
`mvn help:effective-pom`	查看完整 POM（合并父子）
`mvn -Pprod clean package`	激活 prod profile 打包
`mvn -pl my-app -am package`	只构建 my-app 及其依赖模块

实战坑

1. 依赖冲突（`NoClassDefFoundError` / `NoSuchMethodError`）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 查看依赖树
mvn dependency:tree -Dverbose

# 排除传递依赖
<dependency>
 <groupId>com.example</groupId>
 <artifactId>my-lib</artifactId>
 <exclusions>
 <exclusion>
 <groupId>commons-logging</groupId>
 <artifactId>commons-logging</artifactId>
 </exclusion>
 </exclusions>
</dependency>

2. JAR 包冲突定位

1
2
3
4
5
6


# 找哪个 jar 引入的
mvn dependency:tree -Dincludes=com.google.guava:guava

# 输出：
# [INFO] +- com.example:my-lib:jar:1.0:compile
# [INFO] | \- com.google.guava:guava:jar:30.0-jre:compile ← 这里

3. SNAPSHOT 版本不稳定

1.0.0-SNAPSHOT 表示"开发中快照"，Maven 默认每次构建都拉取最新。生产环境应锁定 release 版本。

4. `mvn package` 跳过测试

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 方式 1：命令行参数
mvn package -DskipTests

# 方式 2：surefire 插件配置
<plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-surefire-plugin</artifactId>
 <configuration>
 <skipTests>true</skipTests>
 </configuration>
</plugin>

5. 配置中心化 vs 分散

统一管理：父 POM dependencyManagement 集中版本
覆盖：子模块可显式覆盖（极少数情况）
避免：每个子模块独立写版本号（升级时全项目都要改）

Maven Wrapper（推荐）

mvnw 是项目自带的 Maven 包装脚本，避免开发者本地 Maven 版本不一致：

1
2
3
4
5
6
7
8
9


# 生成 wrapper（项目根目录执行一次）
mvn -N io.takari:maven:0.7.7:wrapper -Dmaven=3.9.6

# 提交到 Git
git add mvnw mvnw.cmd .mvn/
git commit -m "build: 添加 Maven Wrapper"

# 团队成员执行（无需安装 Maven）
./mvnw clean package

私服搭建（Nexus 3.x）

1
2
3
4
5
6


# Docker 一键启动
docker run -d \
 -p 8081:8081 \
 -v /data/nexus-data:/nexus-data \
 --name nexus \
 sonatype/nexus3:3.64.0

部署到 Nexus：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


<!-- 项目 pom.xml -->
<distributionManagement>
 <repository>
 <id>nexus-releases</id> <!-- 对应 settings.xml server id -->
 <url>http://{{NEXUS_HOST}}:8081/repository/maven-releases/</url>
 </repository>
 <snapshotRepository>
 <id>nexus-snapshots</id>
 <url>http://{{NEXUS_HOST}}:8081/repository/maven-snapshots/</url>
 </snapshotRepository>
</distributionManagement>

<build>
 <plugins>
 <plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-deploy-plugin</artifactId>
 </plugin>
 </plugins>
</build>

1

mvn deploy # 部署到 Nexus

前置知识与下一步

前置：

Java 基础语法、IDE 使用
基本的命令行操作
了解 Spring Boot 项目结构

下一步：

复杂构建用 Maven Profile + Resource Filtering 实现多环境打包
配合 Dockerfile + CI/CD 一键出镜像
巨型项目切分用 Maven 多仓库 + 微服务，避免单仓库超大

小结

Maven 3.9 + 阿里云镜像 + 标准 settings.xml 是企业 Java 项目的"开箱即用"组合。多模块项目靠父 POM dependencyManagement 统一版本 + 子 POM 引用简化，是避免"依赖版本地狱"的关键。Maven Wrapper 解决了团队成员本地 Maven 版本不一致的痛点。Nexus 私服是企业内网依赖缓存 + 内部 jar 部署的标配。

2024+ 视角：Maven 4 预览 + Gradle 8 对比

Maven 4.0 关键变化（2024 仍在预发布）

POM 结构化：XML → 仍是 XML，但解析器重写（Lexical 三遍解析），速度 +30%
多语言项目支持：原 Maven 只管 Java，Maven 4 开始支持 JS / Python / Rust 子项目
dependencyManagement 路径表达式：支持 ${groupId:artifactId:type:version} 直接引用父项目
CI 集成深度增强：mvn verify 输出 SBOM（软件物料清单）——合规审计直接用
MVN Daemon（实验）：常驻进程 + 增量编译，类似 Gradle Daemon

Maven 4 升级路径

1
2
3
4
5
6
7
8


<!-- pom.xml 顶部 -->
<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
 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 <modelVersion>4.0.0</modelVersion>
 ...
</project>

主要差异：

POM modelVersion 不变（仍是 4.0.0）
升级命令：mvn -P maven-4-upgrade verify（Maven 4 自带）
大部分插件需升级到 4.x 版本

Gradle 8.x 与 Maven 4 的 2024+ 对比

维度	Maven 4	Gradle 8.x
构建速度	较慢（提升 30%）	快 2-10 倍（增量 + 守护进程）
配置语言	XML	Kotlin DSL / Groovy
增量构建	需 mvn incremental	原生支持
多语言	实验	Kotlin Multiplatform / Android
生态稳定性	25 年沉淀，文档全	较新，插件质量参差
学习曲线	低（约定优于配置）	中（DSL 学习）
企业 Java 占比	70%+	15%

选型建议：

新项目（Kotlin / Android / 复杂构建）：Gradle 8.x
传统 Spring / 金融 / 政府：Maven 仍是首选——团队上手快、CI 配置简单
Kotlin Multiplatform / 跨平台：必须 Gradle

镜像配置的 2024+ 演进

阿里云 2023 年起对 Maven 中央仓库做了全量同步，但 2024 之后新增了：

华为云镜像：https://repo.huaweicloud.com/repository/maven/
腾讯云镜像：https://mirrors.cloud.tencent.com/nexus/repository/maven-public/
中国移动云镜像：https://mirrors.cmecloud.cn/repository/maven/

1
2
3
4
5
6
7


<mirrors>
 <mirror>
 <id>huawei-cloud</id>
 <url>https://repo.huaweicloud.com/repository/maven/</url>
 <mirrorOf>central</mirrorOf>
 </mirror>
</mirrors>

`dependencyManagement` 2024+ 进阶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


<!-- BOM 引用（Bill of Materials）-->
<dependencyManagement>
 <dependencies>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-dependencies</artifactId>
 <version>3.4.0</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 <dependency>
 <groupId>com.alibaba.cloud</groupId>
 <artifactId>spring-cloud-alibaba-dependencies</artifactId>
 <version>2023.0.1.0</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 </dependencies>
</dependencyManagement>

Maven Wrapper 的 2024+ 变化

1
2
3
4
5


# 旧版（Takari wrapper）
mvn -N io.takari:maven:0.7.7:wrapper -Dmaven=3.9.6

# 新版（Maven 官方 wrapper 3.2+）
mvn wrapper:wrapper -Dmaven=3.9.9

新版 wrapper 由 Maven 官方维护，不需要 Takari 仓库。

依赖冲突排查的 2024+ 新工具

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 1. mvn dependency:tree（老牌）
mvn dependency:tree -Dverbose -Dincludes=commons-logging:commons-logging

# 2. maven-dependency-plugin 3.6+：dependency:analyze
mvn dependency:analyze

# 3. Enforcer 插件：禁止某些依赖
<plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-enforcer-plugin</artifactId>
 <version>3.4.1</version>
</plugin>

实战坑（2024+）

Spring Boot 3.x 必须 JDK 17+——Maven 3.8.x 之前的版本不支持 --add-opens，需用 3.9.x
Maven Central 在 2024-06 调整了 HTTPS 证书链——老 Maven 版本（< 3.6.3）需升级
Nexus 3.64+ 强制 HTTPS——HTTP 私服要升级或保留 HTTP 白名单
JCenter 2022 已停止服务——所有 jcenter() 引用要改 mavenCentral()

2024+ 推荐组合

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


企业 Java 项目（Spring Boot 3.x）
├── Maven 3.9.x / Maven 4.0（2024+）
├── 阿里云镜像 + settings.xml
├── Maven Wrapper 3.2+
├── spring-boot-starter-parent 3.4.x
├── spring-cloud-dependencies 2024.0.x BOM
├── spring-cloud-alibaba-dependencies 2023.0.x BOM
├── 父 POM dependencyManagement 统一版本
├── 子 POM 引用无版本号
├── Nexus 3.64+ 私服（maven-releases + maven-snapshots）
└── mvn -Pprod clean package + Jib 打 Docker 镜像

阿里云 on Liangweidong's blog

阿里云 ECS 云盘挂载：分区、扩容与开机自动挂载实战

一、为什么 2025 年还要手挂云盘

二、查云盘

三、场景一：全新数据盘挂载

3.1 一个目录只能挂一个盘

3.2 2T 以下：MBR 分区（fdisk）

3.3 2T+ ：GPT 分区（parted）

3.4 格式化文件系统

3.5 挂载

3.6 写进 /etc/fstab（开机自动挂载）

3.7 验证

四、场景二：把根目录挂到数据盘（一般不要）

4.1 终止占用 /home 进程

4.2 备份 /home

4.3 卸载 /home + 删 lv

4.4 扩展 /root lv

4.5 重建 home

五、场景三：原盘扩容

5.1 控制台扩容

5.2 删旧分区 + 建新分区

5.3 修正文件系统

六、典型坑速查

七、开机自动挂载的最佳实践

7.1 用 UUID 而不是设备名

7.2 加 nofail 选项（云盘场景）

7.3 配 fsck 顺序

八、典型用法速查

九、下一步

参考资料

2024+ 视角：写于 2025-09，半年后阿里云 ESSD 与云原生存储

一、ESSD 已成"默认云盘"（2020+ 趋势的延续）

二、在线扩容的"无重启"姿势

三、云盘快照 + 跨区复制

四、Ultra Disk / 本地盘 SSD 的回归

五、NAS / OSS / 块存储的"三分天下"

六、UltraPath / 多路径 IO

七、fstab 写错导致 ECS 起不来的"无救援模式恢复"

八、/etc/fstab “nofail” 选项的 2024 最佳实践

九、云原生时代的"挂载"

Maven 全套实战：从安装到多模块企业级构建

Maven 全套实战：从安装到多模块企业级构建

背景与价值

安装与配置

1. 下载解压

2. 全局配置文件 ${maven_home}/conf/settings.xml

3. 阿里云镜像配置（关键）

核心概念

1. 坐标（GAV）

2. 仓库类型

3. 依赖范围（Scope）

4. 生命周期阶段

多模块项目（企业级核心）

1. 父 POM 约定

2. 父 POM 完整模板

3. 子模块 POM

常用命令

实战坑

1. 依赖冲突（NoClassDefFoundError / NoSuchMethodError）

2. JAR 包冲突定位

3. SNAPSHOT 版本不稳定

4. mvn package 跳过测试

5. 配置中心化 vs 分散

Maven Wrapper（推荐）

私服搭建（Nexus 3.x）

前置知识与下一步

小结

2024+ 视角：Maven 4 预览 + Gradle 8 对比

Maven 4.0 关键变化（2024 仍在预发布）

Maven 4 升级路径

Gradle 8.x 与 Maven 4 的 2024+ 对比

镜像配置的 2024+ 演进

dependencyManagement 2024+ 进阶

Maven Wrapper 的 2024+ 变化

依赖冲突排查的 2024+ 新工具

实战坑（2024+）

2024+ 推荐组合

2. 全局配置文件 `${maven_home}/conf/settings.xml`

1. 依赖冲突（`NoClassDefFoundError` / `NoSuchMethodError`）

4. `mvn package` 跳过测试

`dependencyManagement` 2024+ 进阶