MetInfo 在 XAMPP 上无法运行，主因是 Apache 权限配置不当：① htdocs 目录所有者需与 Apache 进程用户一致；② upload_tmp_dir 和 session.save_path 必须存在且可写；③ MySQL root 密码为空或连接地址不匹配导致安装卡在数据库校验；④ httpd-xampp.conf 的 403 拦截会阻止 admin/install 访问，需显式授权。
MetInfo 在 XAMPP 上跑不起来，八成不是程序问题，而是权限卡在了三处：Apache 进程没权限读写 htdocs 目录、upload_tmp_dir 临时目录不可写、MySQL 用户没开远程访问（哪怕本地部署，MetInfo 安装向导也可能触发连接校验）。改完任意一处不重启服务，基本等于白改。
Apache 进程用户必须和 htdocs 所有者一致
Linux/macOS 下 XAMPP 默认以 daemon 用户运行 Apache，但 /opt/lampp/htdocs 所有者是 root，导致 MetInfo 安装时无法创建缓存、写入配置文件、上传 logo 等。
- 先查当前 Apache 用户：
ps aux | grep -E "(httpd|apache)" | head -1，看 USER 列（常见为daemon） - 把 htdocs 所有者改成该用户：
sudo chown -R daemon:daemon /opt/lampp/htdocs - 别用
777—— MetInfo 的install/和cache/目录需要写权限，但开放全目录 777 会触发安全拦截（XAMPP 自带的httpd-xampp.conf会直接 403） - Windows 不用改所有者，但要确保
C:\xampp\htdocs目录对NT AUTHORITY\SYSTEM可写（用icacls授权，不是右键属性点几下就行）
upload_tmp_dir 和 session.save_path 必须可写且路径明确
MetInfo 上传模板、附件、后台图片时，PHP 会先存到 upload_tmp_dir，再 move 到目标位置。如果该目录不存在或 Apache 进程无权写入，就会报 move_uploaded_file(): Unable to move 或静默失败（页面卡在“正在上传”）。
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
- 打开
php.ini（C:\xampp\php\php.ini或/opt/lampp/etc/php.ini），确认以下两行未被注释且路径存在： -
upload_tmp_dir = "C:\xampp\tmp"（Windows，双引号不能少） session.save_path = "C:\xampp\tmp"- Linux 下建议设为
/opt/lampp/temp，然后执行：sudo mkdir -p /opt/lampp/temp && sudo chown daemon:daemon /opt/lampp/temp && sudo chmod 700 /opt/lampp/temp - 改完必须重启 Apache，仅重载配置无效
MySQL root@localhost 密码为空会导致 MetInfo 安装卡在数据库连接
MetInfo 安装向导默认填 root + 空密码连 MySQL，但 XAMPP 新版（尤其 Linux/macOS）可能已强制要求设密码，或 MySQL 绑定在 127.0.0.1 而非 localhost，导致 socket 连接失败。
- 先用命令行验证能否连：
/opt/lampp/bin/mysql -u root -p（Linux/macOS）或mysql -u root -p（Windows 命令行，进入C:\xampp\mysql\bin） - 如果提示
Access denied，说明密码不为空 —— 别猜，直接进 phpMyAdmin（http://localhost/phpmyadmin）改mysql.user表里'root'@'localhost'的authentication_string - 如果连得上但 MetInfo 报
Connection refused，检查my.cnf里bind-address是否为127.0.0.1；MetInfo 有时用 TCP 连而非 socket，需确保该地址可通 - 别动
'root'@'%'—— MetInfo 不需要远程访问，开了反而增加风险
httpd-xampp.conf 的 403 拦截常被忽略
MetInfo 安装完首页能打开，但点“后台登录”或“安装向导”就 403，大概率是 XAMPP 自带的安全策略在起作用，它默认只放行 127.0.0.1 访问 /phpmyadmin、/security、/xampp 等路径，而 MetInfo 的 admin/ 或 install/ 目录被一并拦了。
- 编辑
/opt/lampp/etc/extra/httpd-xampp.conf（Linux/macOS）或C:\xampp\apache\conf\extra\httpd-xampp.conf（Windows） - 找到类似
<Directory "/opt/lampp/phpmyadmin">的区块，在其内部把Require local改成Require all granted - 如果 MetInfo 后台在
/admin，还要加一段针对该路径的授权：<Directory "/opt/lampp/htdocs/metinfo/admin"> Require all granted </Directory> - 改完必须重启 Apache，否则配置不加载
MetInfo 对权限敏感的地方不止这些：比如 config/config_db.php 是安装后生成的，如果 Apache 没权限写入，整个流程就断在最后一步；又比如 cache/ 目录若不可写，后台操作会极慢甚至超时。与其反复试错，不如一开始就按进程用户统一所有权、显式声明 tmp 路径、关掉冗余安全拦截——这三件事做完，90% 的“部署失败”就消失了。
