常见安装问题

安装向导提示”数据目录不可写”

数据目录必须由 Web 进程用户（通常 www-data）可写，且位于 Web 根目录之外：

mkdir -p /var/www/elgg-data
chown www-data:www-data /var/www/elgg-data
chmod 750 /var/www/elgg-data

SELinux 启用的系统还需设置上下文：chcon -R -t httpd_sys_rw_content_t /var/www/elgg-data。

安装后页面样式错乱 / 404

两个常见原因：

1. URL 重写未生效：Nginx 检查 try_files 是否包含 /index.php?$query_string；Apache 检查 mod_rewrite 与 AllowOverride All
2. 缓存未刷新：后台手动点击”清除缓存”，或删除数据目录下 caches/ 内容后重试

上传图片不显示

数据目录路径配置错误或权限问题。确认：

• 后台设置中的数据目录路径与磁盘一致
• Web 进程用户对该目录可写
• 图片 URL 不应直接指向数据目录——静态资源由站点路由输出

验证邮件收不到

按顺序检查：

1. PHP mail() 是否可用：php -r "mail('test@example.com','t','t');"（多数云服务器默认不可用）
2. 是否配置了 SMTP（推荐，见数据库与邮件配置）
3. 服务器是否有出站 25/465/587 端口限制（云厂商常默认封 25 端口）
4. 收件方垃圾箱

“Plugin X requires plugin Y” 冲突

插件列表顺序问题。Elgg 插件按列表从上到下加载，被依赖的插件必须排在依赖方之上。在插件管理页拖动排序后保存。

数据库报 utf8mb4 相关错误

手工建库时遗漏字符集设置。用以下语句重建：

CREATE DATABASE elgg_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

已有站点出现该问题需谨慎处理，涉及表结构转换，建议备份后操作。

仍有问题？

• 优先查阅官方英文文档与 GitHub Issues
• 涉及升级、插件开发或环境排查的实施需求，可通过 elgg.biz 提交咨询