云信AI部署

从入门到精通：GitHub MySQL项目在Apple Silicon M2的部署实战

云信安装大师
90
AI 质量分
11 5 月, 2025
3 分钟阅读
0 阅读

从入门到精通：GitHub MySQL项目在Apple Silicon M2的部署实战

引言

随着Apple Silicon M系列芯片的普及，许多开发者需要在M1/M2设备上部署MySQL数据库进行开发测试。本文将手把手教你如何在Apple Silicon M2芯片的Mac上从GitHub克隆MySQL项目并完成本地部署，涵盖从环境准备到成功运行的完整流程。

准备工作

环境要求

  • Apple Silicon M1/M2芯片的Mac电脑
  • macOS Monterey (12.0) 或更高版本
  • Homebrew包管理器（已安装）
  • Xcode命令行工具（已安装）

前置知识

  • 基本的终端命令行操作
  • 对MySQL有基础了解

详细步骤

1. 安装必要的依赖

首先打开终端，执行以下命令安装必要工具：

代码片段 
# 更新Homebrew确保是最新版本
brew update

# 安装编译工具链
brew install cmake pkg-config openssl@3

# 安装bison (MySQL依赖的解析器生成器)
brew install bison

注意事项：
– Apple Silicon芯片需要确保所有软件都通过Rosetta或原生ARM版本运行
– openssl@3是必须的，因为MySQL需要SSL支持

2. 克隆MySQL源码

我们以MySQL官方仓库为例：

代码片段 
# 进入你的工作目录
cd ~/Developer

# 克隆MySQL源码 (这里以8.0分支为例)
git clone --branch=8.0 https://github.com/mysql/mysql-server.git mysql-server
cd mysql-server

3. 配置编译环境

创建构建目录并运行cmake配置：

代码片段 
mkdir build && cd build

# ARM架构专用编译配置
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/mysql \
         -DCMAKE_OSX_ARCHITECTURES=arm64 \
         -DWITH_SSL=/opt/homebrew/opt/openssl@3 \
         -DDEFAULT_CHARSET=utf8mb4 \
         -DDEFAULT_COLLATION=utf8mb4_general_ci \
         -DENABLED_LOCAL_INFILE=ON \
         -DWITH_BOOST=../boost

参数解释：
– CMAKE_OSX_ARCHITECTURES=arm64：指定为ARM架构编译
– WITH_SSL：指定OpenSSL路径（Homebrew安装位置）
– WITH_BOOST：MySQL需要的Boost库路径

4. 编译和安装

代码片段 
# 开始编译（使用8个线程加速）
make -j8

# 安装到指定目录
sudo make install

实践经验：
– M2芯片编译速度很快，大约15-30分钟即可完成
– -j8参数表示使用8个线程并行编译，可根据CPU核心数调整

5. 初始化MySQL数据库

代码片段 
cd /usr/local/mysql

# 初始化数据库文件（注意记录输出的root临时密码）
sudo bin/mysqld --initialize --user=mysql --basedir=/usr/local/mysql --datadir=/usr/local/mysql/data

# 设置权限
sudo chown -R mysql:mysql /usr/local/mysql/data

6. 启动MySQL服务

代码片段 
# macOS下使用launchctl管理服务（推荐方式）
sudo cp support-files/mysql.server /etc/init.d/mysql.server.plist 
sudo launchctl load -w /etc/init.d/mysql.server.plist 

# 或者直接启动（调试用）
sudo bin/mysqld_safe --user=mysql &

7. 首次登录并修改密码

使用之前初始化时生成的临时密码登录：

代码片段 
/usr/local/mysql/bin/mysql -u root -p 

-- MySQL命令行中执行以下命令修改密码：
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';
FLUSH PRIVILEGES;
exit;

MySQL常用管理命令

代码片段 
# macOS下启动服务 
sudo launchctl start mysql.server.plist 

# macOS下停止服务 
sudo launchctl stop mysql.server.plist 

# macOS下查看状态 
sudo launchctl list | grep mysql 

# MySQL命令行客户端连接 
/usr/local/mysql/bin/mysql -u root -p

M2芯片特有优化建议

  1. 性能调优：在my.cnf中添加以下配置利用M2性能优势：

    代码片段 
    [mysqld]
innodb_buffer_pool_size = 4G    # M2内存充足可适当加大  
innodb_flush_method = O_DIRECT  
skip-name-resolve               # ARM架构DNS解析有时较慢

  2. 温度控制：长时间高负载时建议使用Macs Fan Control监控温度。

Troubleshooting常见问题解决指南

问题1: cmake报错找不到openssl
解决:

代码片段 
export OPENSSL_ROOT_DIR=/opt/homebrew/opt/openssl@3  
然后重新运行cmake

问题2: make过程中内存不足
解决:
减少并行编译线程数: make -j4

问题3: MySQL无法启动，报错”Can’t connect to local MySQL server”
解决:
检查错误日志: /usr/local/mysql/data/*.err
常见原因是权限问题: sudo chown -R mysql:mysql /usr/local/mysql/data

GitHub项目开发实战技巧

如果你想基于GitHub上的MySQL分支进行开发：

  1. Fork工作流:

    代码片段 
    # Fork官方仓库到你自己的GitHub账号后:  
git clone git@github.com:你的用户名/mysql-server.git   
git remote add upstream https://github.com/mysql/mysql-server.git   

# sync with upstream:  
git fetch upstream   
git merge upstream/8.0

  2. 提交Pull Request前测试:
    务必在M2上完整运行测试套件:

    代码片段 
    cd build && ctest --output-on-failure

Docker替代方案（适合快速测试）

如果你不想本地编译，可以使用Docker for Mac(ARM64版本):

代码片段 
docker run --name some-mysql \   
           -e MYSQL_ROOT_PASSWORD=my-secret-pw \   
           -p3306:3306 \   
           -d mysql:latest \   
           --platform linux/arm64/v8

Visual Studio Code集成开发

推荐安装以下扩展提升开发效率：
1. MySQL (由cweijan提供) – SQL智能提示
2. Remote SSH/Docker容器开发

调试配置(.vscode/launch.json):

代码片段 
{   
    "version": "0.2.0",    
    "configurations": [    
        {    
            "name": "(lldb) Launch",    
            "type": "cppdbg",    
            "request": "launch",    
            "program": "/usr/local/mysql/bin/mysqld",    
            "args": ["--debug"],    
            "stopAtEntry": false,    
            "cwd": "${workspaceFolder}",    
            "environment": [],    
            "externalConsole": false,    
            "MIMode": "lldb"    
        }    
    ]    
}

Git最佳实践建议

  1. 分支策略: feature分支开发 + rebase上游变更保持整洁历史记录

  2. 提交信息规范:
    示例好的commit message:

    代码片段 
    WL#12345: Implement JSON aggregation functions      

Description:      
This patch implements JSON_ARRAYAGG() and JSON_OBJECTAGG()...      

Change-Id: I1234567890abcdef

ARM64架构深度优化技巧

针对Apple Silicon的特性调整CMake参数可提升10%-15%性能:

代码片段 
cmake .. \     
     -DCMAKE_C_FLAGS="-mcpu=apple-m1" \     
     -DCMAKE_CXX_FLAGS="-mcpu=apple-m1" \     
     ...其他参数...

还可以启用LTO(Link Time Optimization):

代码片段 
-DWITH_LTO=ON

Benchmark性能测试

使用sysbench对比Rosetta转译与原生ARM64性能差异(测试脚本):

代码片段 
sysbench oltp_read_write \     
         --db-driver=mysql \     
         --mysql-host=127.0.0.1 \     
         --mysql-port=3306 \     
         --mysql-user=root \     
         --mysql-password='你的密码' \     
         prepare     

sysbench oltp_read_write ... run     

sysbench ... cleanup

CI/CD集成建议

GitHub Actions示例(.github/workflows/build.yml):

代码片段 
name: MySQL ARM64 Build      

on: [push, pull_request]      

jobs:      
 build:
 runs-on: macos-latest       
 steps:
      uses: actions/checkout@v3       
      name: Build MySQL        
      run: |
          brew install cmake bison openssl@3         
          mkdir build && cd build         
          cmake .. ${CMAKE_FLAGS}          
          make -j$(sysctl -n hw.ncpu)          
          ctest --output-on-failure

通过这篇教程，你已经掌握了在Apple Silicon M系列芯片上从源码构建和优化MySQL的全部技能。无论是为了学习数据库原理、参与开源贡献还是企业级应用开发，这些知识都将为你打下坚实基础。

原创 高质量