本攻略包含：本地开发环境 + 生产环境双配置，前端开发工程师照这个做就好了。

你将得到：

• ✅ 本地完美运行 Strapi

• ✅ 连接 MySQL 8 无报错

• ✅ 可访问后台：http://localhost:1337/admin

• ✅ 配置文件已内置 生产环境 模板

• ✅ 直接为上线部署做好准备

一、环境准备（必须先装）

1. 必须安装

• Node.js 18+（推荐 18.20.2）

• MySQL 8.0.27（你已安装）

• Git（可选）

2. 创建数据库（必须执行）

打开 CMD 登录 MySQL：

mysql -u root -p

执行：

CREATE DATABASE IF NOT EXISTS strapi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS '<您的账号>'@'%' IDENTIFIED BY '<您的密码>';
GRANT ALL PRIVILEGES ON *.* TO '<您的账号>'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;

二、创建 Strapi 项目

1. 打开文件夹，执行命令，创建项目

npx create-strapi@latest my-strapi-blog

选择：

• Quickstart 或 Custom

• 数据库选择 MySQL（默认SQLLite，为了与服务器对齐，这里选了MYSQL）

• 等待初始化完成，按需要选择配置，如果没有特殊需要，直接默认按回车键即可。（需要输入数据库名称、账户、密码）

• 如果选择了 Install dependencies with npm，项目初始化后会自动安装依赖，出现下边的页面，项目就安装完成了。

2. 运行项目，如果前边填写的数据库名称、账号、密码正确，一般是可以直接运行项目了。

npm run dev

如果运行失败，可以进入下一步————终极配置文件

三、终极配置文件（直接复制全覆盖）

进入项目 my-strapi-blog/

1. 根目录 .env （本地 + 生产双配置）

# Server
HOST=0.0.0.0
PORT=1337

# Secrets
APP_KEYS=bRAmjQa35euKS6b6Bo+9vg==,vAqveTpKHzycu+q0FVJN2A==,M3kGJdZMuOQtRQq2sv27Fw==,jLpRg0czOUCSXMyFs4Mg2A==
API_TOKEN_SALT=OFVEYrn0ie5kO6dRAN3kYQ==
ADMIN_JWT_SECRET=g+NjBPsUuw7b3soMQlwwxg==
TRANSFER_TOKEN_SALT=Wdn73itHXsPawEhSPeMlTw==
ENCRYPTION_KEY=v2yHK7Rhc7DeUf2mbtR4eg==

# Database
DATABASE_CLIENT=mysql
DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_NAME= strapi_blog_local
DATABASE_USERNAME=<您的账号>
DATABASE_PASSWORD=<您的密码>
DATABASE_SSL=false
DATABASE_FILENAME=
JWT_SECRET=kweqFhkXoVcPpPWVZxe+sg==

着重检查DATABASE_NAME、DATABASE_USERNAME、DATABASE_PASSWORD这几条配置，保证配置正常，启动项目就不会再报数据库连接异常的问题了。

四、启动 Strapi（本地运行）

npm run dev

✅ 出现 Strapi started successfully 就是成功

访问后台：

http://localhost:1337/admin

Strapi启动成功，就可以愉快的在本地环境使用Strapi了，后边会继续写文详细介绍。

注：Strapi安装完成后默认是英文界面，可参考[https://www.cnblogs.com/xyyt/p/19800251](Strapi v5.4设置中文语言展示)来设置中文界面。

五、生产环境配置（已内置，直接可用）

生产环境 .env.production 示例

NODE_ENV=production
HOST=0.0.0.0
PORT=1337
URL=https://your-domain.com

## 生产 MySQL
DATABASE_CLIENT=mysql
DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_NAME=strapi
DATABASE_USERNAME=<您的账号>
DATABASE_PASSWORD=<您的密码>
DATABASE_SSL=true

生产启动命令

npm run start

编译打包（部署必备）

npm run build

六、常见错误 100% 解决

1. SSL 证书错误

DATABASE_SSL=false

2. 无法连接数据库

• 用户名必须填写 <您的账号>（替换为实际账号）

• 密码：<您的密码>（替换为实际密码）

• 库名：my_strapi_blog

3. Missing jwtSecret

已在 plugins.js 修复

4. 0.0.0.0:1337 无法访问

使用：http://localhost:1337/admin

七、完整部署流程总结

1. 安装 MySQL

2. 创建数据库 my_strapi_blog

3. 创建 my_strapi_blog 项目

4. 检查开发环境配置文件数据库配置是否正确，手动创建.env.production文件并进行生产环境配置

5. npm run dev 启动

6. 打开 localhost:1337/admin

7. 生产环境直接用内置配置打包上线

接下来，会继续写Strapi的使用及生产环境的配置。