常见问题

安装部署

Q: 页面显示 404 错误

A: 这通常是 URL 重写未生效导致的。

解决方法：

1. 检查 .htaccess 文件是否存在
2. Apache 需要启用 mod_rewrite 模块
3. 确认 AllowOverride All 配置
4. Nginx 需要配置正确的 try_files 规则

Q: 静态资源加载失败（CSS/JS/图片）

A: 路径配置问题。

解决方法：

1. 确认运行目录为项目根目录（不是 /public）
2. 检查 static/ 目录是否存在
3. 检查文件权限

Q: 数据库连接失败

A: 配置信息错误或服务未启动。

解决方法：

1. 检查 .env 中的数据库配置
2. 确认 MySQL 服务正在运行
3. 测试连接：mysql -u root -p
4. 检查数据库是否存在

Q: 图片上传失败

A: 目录权限或 PHP 配置问题。

解决方法：

# 设置目录权限
chmod -R 777 storage

# 检查 PHP 配置
upload_max_filesize = 10M
post_max_size = 20M

Q: 页面显示 500 错误

A: 服务器内部错误。

解决方法：

1. 查看错误日志：runtime/log/
2. 确认 PHP 版本 >= 8.0
3. 检查目录权限
4. 开启调试模式查看详细错误

功能使用

Q: 如何成为管理员？

A: 第一个注册的用户自动成为管理员。

如需手动设置：

1. 登录数据库
2. 修改 users 表的 is_admin 字段为 1

Q: 图片上传大小限制如何修改？

A: v1.1.0 版本可以在管理后台直接修改：

1. 登录管理后台 → 系统设置 → 上传设置
2. 修改 upload_max_size 配置项
3. 点击保存

同时需要修改 php.ini：

upload_max_filesize = 20M
post_max_size = 30M

Q: 如何修改系统设置？

A: v1.1.0 版本新增了可视化系统设置功能：

1. 登录管理后台
2. 点击"系统设置"标签页
3. 选择配置分组（系统/上传/安全/性能/功能）
4. 修改配置项
5. 点击保存

支持的配置分组：

• 系统设置: 站点名称、SEO配置、Logo等
• 上传设置: 文件大小、扩展名、缩略图等
• 安全设置: 限流、CSRF、XSS、Cookie等
• 性能设置: APM、缓存等
• 功能开关: 注册、评论、审核等

Q: 如何开启 Redis 缓存？

A:

1. 安装 Redis 服务
2. 安装 PHP Redis 扩展
3. 配置 config/cache.php

Q: 如何配置邮件发送？

A: 编辑 config/mail.php 配置 SMTP 信息。

Q: 队列任务如何启动？

A:

# 启动队列监听
php think queue:listen

# 或使用 Supervisor 管理

问题排查

Q: 如何查看错误日志？

A:

# 查看最新错误
tail -f runtime/log/$(date +%Y%m)/$(date +%d).log

# 或在 runtime/log/ 目录查找

Q: 如何清除缓存？

A:

php think clear

Q: 如何开启调试模式？

A:

# .env
APP_DEBUG = true

Q: 如何备份数据？

A:

# 备份数据库
mysqldump -u root -p photo_gallery > backup.sql

# 备份上传文件
tar -czf storage.tar.gz storage/

性能优化

Q: 页面加载很慢怎么办？

A:

1. 启用 Redis 缓存
2. 开启 OPcache
3. 启用 Gzip 压缩
4. 配置静态资源缓存
5. 使用 CDN

Q: 数据库查询很慢？

A:

1. 检查索引是否正确
2. 开启慢查询日志分析
3. 优化 SQL 语句
4. 增加数据库缓存

安全相关

Q: 如何防止恶意上传？

A: 系统已实现 6 层上传安全验证。

Q: 如何配置 HTTPS？

A:

1. 获取 SSL 证书（Let's Encrypt）
2. 配置 Web 服务器
3. 强制 HTTPS 跳转

Q: 如何限制访问频率？

A: v1.1.0 版本可以在管理后台配置：

1. 登录管理后台 → 系统设置 → 安全设置
2. 开启 rate_limit_enabled
3. 配置各接口的限流参数：
   • rate_limit_default_max: 默认每分钟最大请求数
   • rate_limit_upload_max: 上传接口限制
   • rate_limit_login_max: 登录接口限制
   • rate_limit_admin_max: 管理接口限制

其他问题

Q: 支持第三方登录吗？

A: 目前暂未实现，计划在后续版本支持微信、QQ、微博登录。

Q: 支持多语言吗？

A: 目前仅支持中文，多语言功能在开发计划中。

Q: 如何获取技术支持？

A:

1. 查阅本文档
2. 在 Gitee 提交 Issue
3. 联系作者 QQ: 42033223

获取更多帮助

如果以上内容未能解决您的问题，请：

1. 仔细阅读错误日志
2. 搜索相关错误信息
3. 在 Gitee 仓库提交 Issue，附上：
   • 详细的错误描述
   • 错误日志内容
   • 操作步骤
   • 系统环境信息