FastAdmin在XAMPP上运行需三步关键配置：一是启用mbstring、openssl、pdo_mysql、zip等PHP扩展；二是Apache启用mod_rewrite并设AllowOverride All，确保public目录为Web根目录；三是MySQL使用utf8mb4字符集并赋予足够权限，同时runtime目录需开放写入权限。
FastAdmin 在 XAMPP 上能跑起来，但默认配置下大概率会报错或白屏——核心问题不在框架本身，而在 PHP 模块缺失、URL 重写未启用、以及 public 目录没被正确设为 Web 根目录。
PHP 扩展必须手动确认并启用
FastAdmin 基于 ThinkPHP 5.1+，依赖几个关键扩展，XAMPP 自带的 PHP 并不默认全部开启：
-
mbstring：字符串处理必需，否则模板解析失败，页面空白 -
openssl：用于 HTTPS 请求、加密组件，登录页可能卡住或跳转异常 -
pdo_mysql：数据库驱动，没它连不上 MySQL，安装向导直接报Class 'PDO' not found -
zip：插件安装、模块打包依赖，否则php think addon:install报错Class 'ZipArchive' not found
操作方式：打开 XAMPP 控制面板 → Apache → Config → PHP (php.ini)，搜索对应扩展项，取消注释（去掉前面的分号），保存后重启 Apache。验证命令：php -m | grep -E "mbstring|openssl|pdo_mysql|zip"。
Apache 必须启用 mod_rewrite 并配置 .htaccess
ThinkPHP 的 URL 路由依赖 Apache 的重写模块，XAMPP 默认关闭它，且 .htaccess 文件在 FastAdmin 的 public/ 目录下，但若 Web 根目录设错，该文件根本不会生效。
立即学习“PHP免费学习笔记（深入）”；
- 确认
httpd.conf中已取消注释：LoadModule rewrite_module modules/mod_rewrite.so - 找到
<Directory ""/xampp/htdocs">区块，把AllowOverride None改成AllowOverride All - 将 FastAdmin 整个项目解压到
XAMPP/htdocs/fastadmin/后，不要直接访问http://localhost/fastadmin/，而是把fastadmin/public/设为实际 Web 入口——最稳妥做法是修改 Apache 虚拟主机，指向fastadmin/public；若不想改配置，就复制public下所有文件（含.htaccess）到htdocs/fastadmin/，再删掉原public目录（否则路由会多一层/public/）
MySQL 字符集与权限要提前对齐
FastAdmin 安装向导创建数据表时，如果 MySQL 默认字符集不是 utf8mb4，或用户没授予 CREATE 权限，会卡在“正在初始化数据库”并报错 SQLSTATE[HY000]: General error: 1709 Index column size too large 或 Access denied for user。
- 用 phpMyAdmin 或命令行登录 MySQL，执行：
SHOW VARIABLES LIKE 'character_set%';，确保character_set_server和collation_server是utf8mb4和utf8mb4_unicode_ci - 创建专用数据库时，显式指定编码：
CREATE DATABASE fastadmin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; - 创建用户并授权：
CREATE USER 'fa_user'@'localhost' IDENTIFIED BY 'your_pass'; GRANT ALL PRIVILEGES ON fastadmin.* TO 'fa_user'@'localhost'; FLUSH PRIVILEGES;
运行时权限和缓存路径别硬编码
Windows 下 XAMPP 的 PHP 进程默认以 SYSTEM 或当前用户身份运行，runtime/ 目录若没写入权限，会导致日志无法生成、模板缓存失败、甚至后台登录后 403。
- 手动给
fastadmin/runtime/和fastadmin/application/cache/设置“完全控制”权限（右键 → 属性 → 安全 → 编辑） - 检查
application/config.php中的'runtime_path'是否为相对路径（如../runtime/），避免写死绝对路径（如C:/xampp/htdocs/...） - 首次安装后，清空
runtime/下所有子目录（cache、log、temp），再访问后台，让框架重新生成干净缓存
真正卡住人的往往不是“装不上”，而是 public 目录没暴露、.htaccess 被忽略、或者 runtime 权限不够——这三个点不排查完，调试日志里看不到真实错误，只看到空白页或 500。
