一、目录无写入权限（提示 “Failed to write to directory”）
- 解决办法：
- 修改目录权限：Linux/macOS 执行chmod -R 755 目录路径（如storage、uploads目录），允许读写执行。
- Windows 右键目录→“属性”→“安全”→“编辑”，给当前用户添加 “写入” 权限。
- 确认目录所有者是否正确（Linux 下可通过chown -R www-data:www-data 目录路径设置为 Web 服务用户）。
二、文件路径错误（提示 “File not found”）
- 解决办法：
- 检查项目中引用的文件路径是否使用绝对路径（如__DIR__ . ‘/config.php’），避免相对路径层级错误。
- 确认大小写是否匹配（Linux 系统路径区分大小写，如Config.php与config.php视为不同文件）。
- 查看 Web 服务器配置的根目录是否正确（如 Nginx 的root /var/www/project/public;需指向项目入口目录）。
三、.htaccess 文件不生效（URL 重写失败）
- 解决办法：
- 确认 Apache 已启用mod_rewrite模块（PHPStudy 中 “Apache”→“设置”→“模块” 勾选rewrite_module）。
- 在httpsd.conf中设置目录允许重写：AllowOverride All（默认可能为None）。
- 检查.htaccess文件是否存在于项目根目录，语法是否正确（可参考框架官方示例）。
四、项目文件被安全软件误删（如index.php丢失）
- 解决办法：
- 从安全软件隔离区恢复被误删的文件，并添加到白名单。
- 暂时关闭实时防护，重新解压 / 拉取项目文件。
- 确认项目来源安全（从官方仓库或可信渠道获取），避免包含恶意代码。
五、符号链接（软链接）失效（提示 “Cannot stat symbolic link”）
- 解决办法：
- Linux/macOS 重新创建软链接：ln -s 目标路径 链接名称（确保目标路径存在）。
- Windows 使用mklink /d 链接名称 目标路径（需管理员权限）。
- 若项目部署在 Windows 系统，避免使用软链接，直接复制文件到对应目录。