数据库配置

一、创建数据库

宝塔建站时如果勾选了数据库，已经建好了。没建的话：

1. 宝塔 → 数据库 → 添加数据库
2. 填：

| 字段 | 建议 | |---|---| | 数据库名 | xiehui | | 用户名 | xiehui | | 密码 | 随机生成（记下来） | | 字符集 | utf8mb4 | | 访问权限 | 本地服务器 |

字符集必须 utf8mb4，否则 emoji 和部分中文会乱码。

二、导入 SQL

方式一：宝塔 phpMyAdmin

1. 宝塔 → 数据库 → 管理（进 phpMyAdmin）
2. 选择你的数据库
3. 导入 → 选择 database.sql → 执行

方式二：命令行

mysql -u xiehui -p 你的库名 < /www/wwwroot/你的域名/database.sql

导入后，删掉 database.sql（里面有初始账号信息，别留在服务器上）。

三、配置 .env

打开站点根目录的 .env：

APP_NAME="协会管理系统"
APP_ENV=production
APP_KEY=base64:xxxxxxxxxxxx
APP_DEBUG=false
APP_URL=https://xiehui.yourdomain.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=xiehui
DB_USERNAME=xiehui
DB_PASSWORD=你刚才的密码

CACHE_STORE=database
QUEUE_CONNECTION=database
SESSION_DRIVER=database

重点：

• APP_URL 必须是完整域名（含 https），后面授权、回调、图片都用它
• APP_DEBUG=false（生产环境必须关，否则报错会暴露代码路径）
• APP_KEY 是安装包自带的，不要改（改了已加密的数据解不开）

四、生成 APP_KEY（仅新装需要）

如果 .env 里 APP_KEY 是空的：

php artisan key:generate

五、验证数据库连通

php artisan migrate:status

能列出表清单就说明连通了。

六、初始化管理员

导入的 SQL 里通常带一个默认管理员：

后台地址： https://你的域名/admin
账号：     admin
密码：     admin123

首次登录后立刻改密码，路径：后台 → 右上角头像 → 修改密码。

七、常见报错

| 报错 | 解决 | |---|---| | SQLSTATE[HY000] [1045] Access denied | .env 里数据库用户名/密码错 | | Unknown database | 库名写错，或没建库 | | Specified key was too long | MySQL 版本太低，换 5.7+ | | 1049 Unknown database | 数据库不存在 |

下一步：环境变量配置