部署与运维/故障排查
安装与启动常见问题
解决环境检查、数据库连接、目录权限和端口占用问题。
版本、适用对象与验证信息
- 文档类型
- 故障排查
- 适用版本
- 当前稳定版
- 阅读对象
- 开发者
- 预计阅读
- 7 分钟
- 验证日期
- 2026-09-27
启动时提示端口被占用
更换本地端口，例如 php think run -H 127.0.0.1 -p 8124，并确认防火墙没有阻止本地访问。
数据库迁移失败
检查 .env 中的主机、端口、数据库名和账号权限，确保目标数据库已创建且编码为 utf8mb4。
页面可以打开但样式异常
先执行 pnpm install --frozen-lockfile 和 pnpm assets:build，然后清理浏览器缓存并重新加载。
runtime 无法写入
确保 PHP 运行用户对 runtime 和 public/storage 目录拥有写权限。