部署已搭建好的网站到腾讯云服务器过程中，安装数据库的详细步骤

系统环境：Ubuntu 22.04 LTS (jammy)

MariaDB 版本：11.4.10（实际安装版本，11.4 分支最新）

================================================================================

步骤1：准备工作 - 更新系统并安装依赖

================================================================================

# 1. 更新系统包列表

sudo apt update

# 2. 安装必要的依赖工具

sudo apt install -y software-properties-common gnupg2 wget curl

================================================================================

步骤2：添加 MariaDB 11.4 官方仓库（使用阿里云镜像）

================================================================================

# 1. 删除可能存在的旧仓库配置

sudo rm -f /etc/apt/sources.list.d/mariadb.list*

# 2. 手动添加阿里云 MariaDB 11.4 镜像源

sudo tee /etc/apt/sources.list.d/mariadb.list > /dev/null <<EOF

# MariaDB 11.4 repository - Ubuntu 22.04 (jammy) - Aliyun Mirror

deb [arch=amd64] https://mirrors.aliyun.com/mariadb/repo/11.4/ubuntu jammy main

EOF

# 3. 导入 MariaDB GPG 密钥

sudo wget -O /etc/apt/trusted.gpg.d/mariadb.asc 'https://mariadb.org/mariadb_release_signing_key.asc'

# 4. 刷新软件包列表

sudo apt update

# 5. 验证可安装版本（可选，查看会安装哪个版本）

apt-cache policy mariadb-server

================================================================================

步骤3：安装 MariaDB

================================================================================

# 安装 MariaDB 服务器和客户端

sudo apt install -y mariadb-server mariadb-client

注意事项：

- 安装过程中会出现配置界面，按 Tab 键切换按钮，按 Enter 确认

- 如果界面卡住无响应，按 Ctrl+C 退出，改用非交互安装：

  export DEBIAN_FRONTEND=noninteractive

  sudo -E apt install -y mariadb-server mariadb-client

  unset DEBIAN_FRONTEND

# 启动并设置开机自启

sudo systemctl start mariadb

sudo systemctl enable mariadb

# 检查服务状态

sudo systemctl status mariadb

# 验证安装版本

mariadb --version

# 输出应为：mariadb from 11.4.10-MariaDB, client 15.2 for debian-linux-gnu (x86_64)

================================================================================

步骤4：配置 MariaDB（OpenCms 官方推荐优化）

================================================================================

# 编辑配置文件

sudo vi /etc/mysql/mariadb.conf.d/50-server.cnf

# vi 编辑器操作说明：

# - 按 i 进入编辑模式

# - 找到 [mariadbd] 段落（注意：MariaDB 11.4 使用 [mariadbd]，不是 [mysqld]）

# - 在 [mariadbd] 下添加以下配置

# - 编辑完成后按 Esc 退出编辑模式

# - 输入 :wq 保存并退出

在 [mariadbd] 段落下添加以下 Cms 优化配置：

max_allowed_packet = 256M

innodb_flush_log_at_trx_commit = 2

innodb_buffer_pool_size = 1536M

innodb_log_file_size = 512M

character-set-server = utf8mb4

collation-server = utf8mb4_unicode_ci

skip_name_resolve = 1

# 如果 vi 编辑时出现 swap 文件警告：

# - 提示：Found a swap file... [O]pen Read-Only, (E)dit anyway, (R)ecover, (Q)uit, (A)bort

# - 按 q 退出，然后删除交换文件：

sudo rm /etc/mysql/mariadb.conf.d/.50-server.cnf.swp

# - 重新编辑即可

# 保存后重启 MariaDB 使配置生效

sudo systemctl restart mariadb

# 验证配置是否生效

sudo mariadb -e "SHOW VARIABLES LIKE 'character_set_server';"

# 输出应为：character_set_server | utf8mb4

sudo mariadb -e "SHOW VARIABLES LIKE 'innodb_buffer_pool_size';"

# 输出应为：innodb_buffer_pool_size | 1610612736  (约等于 1536M)

================================================================================

步骤5：设置密码和创建数据库

================================================================================

# 设置密码环境变量（根据实际需求修改密码）

export DB_ROOT_PWD='wangzhanzhizuo9.com.cn'

export DB_wangzhanjianshe9PWD='wangzhanjianshe9.com.cn'

# 验证环境变量是否设置成功

echo $DB_ROOT_PWD

echo $DB_wangzhanjianshe9PWD

# 设置 root 密码（初次安装 root 默认无密码）

sudo mariadb -e "ALTER USER 'root'@'localhost' IDENTIFIED BY '${DB_ROOT_PWD}';"

# 验证 root 密码

sudo mariadb -p"${DB_ROOT_PWD}" -e "SELECT VERSION();"

# 输出应显示：11.4.10-MariaDB

================================================================================

步骤6：验证安装

================================================================================

# 查看已创建的数据库

mariadb -uroot -p"${DB_ROOT_PWD}" -e "SHOW DATABASES;"

# 验证字符集配置

sudo mariadb -p"${DB_ROOT_PWD}" -e "SHOW VARIABLES LIKE 'character_set%';"

# 验证 innodb 配置

sudo mariadb -p"${DB_ROOT_PWD}" -e "SHOW VARIABLES LIKE 'innodb_buffer_pool_size';"

================================================================================

常见问题及解决方案

================================================================================

问题1：安装时提示"Could not get lock /var/lib/dpkg/lock-frontend"

解决：

# 查看占用进程

ps aux | grep apt

# 杀掉占用进程（替换 XXXX 为实际进程ID）

sudo kill -9 XXXX

# 删除锁文件

sudo rm /var/lib/dpkg/lock-frontend

sudo rm /var/lib/dpkg/lock

sudo rm /var/lib/apt/lists/lock

sudo rm /var/cache/apt/archives/lock

# 重新配置

sudo dpkg --configure -a

sudo apt update

问题2：网络中断导致安装失败

解决：

# 清理中断的安装

sudo dpkg --configure -a

sudo apt --fix-broken install

# 清理缓存

sudo apt clean

# 重新安装

sudo apt install -y mariadb-server mariadb-client

问题3：密码认证失败

解决：确保环境变量与实际密码一致，重新执行 export 命令

================================================================================

安装完成清单

================================================================================

✓ MariaDB 版本：11.4.10

✓ Root 密码：wangzhanzhizuo9.com.cn

✓ 用户主机：localhost 和 127.0.0.1

✓ 优化配置：已启用（innodb_buffer_pool_size=1536M 等）

✓ 开机自启：已启用

================================================================================

下一步：安装 Java 和 Tomcat

================================================================================

MariaDB 安装配置完成，可以继续安装：

1. OpenJDK 17

2. Apache Tomcat 10.1

（请参考对应的安装文档）