不会后端不用愁，Strapi解你忧——Windows 11 本地完整部署 Strapi + MySQL 8 实操攻略，从下载到配置启动全指南

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

你将得到：

✅ 本地完美运行 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

七、完整部署流程总结

安装 MySQL
创建数据库 my_strapi_blog
创建 my_strapi_blog 项目
检查开发环境配置文件数据库配置是否正确，手动创建.env.production文件并进行生产环境配置
npm run dev 启动
打开 localhost:1337/admin
生产环境直接用内置配置打包上线

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

posted on 2026-03-31 16:24 码间留白阅读(102) 评论(0) 收藏举报

刷新页面返回顶部