一、Composer 依赖安装失败（composer install时报错）
- 解决办法：
- 更换国内镜像源：composer config -g repo.packagist composer https://packagist.phpcomposer.com。
- 检查composer.json语法是否正确（可通过在线 JSON 校验工具验证）。
- 删除vendor目录和composer.lock文件，重新执行composer install。
- 确保 PHP 版本满足composer.json中require.php的版本要求。
二、数据库连接失败（提示 “Access denied for user ‘root’@’localhost’”）
- 解决办法：
- 检查项目配置文件（如config/database.php）中的数据库账号、密码、端口是否与实际一致（默认端口 3306）。
- 确认 MySQL 服务已启动（PHPStudy 中 “MySQL” 状态为 “运行中”）。
- 重置数据库密码：MySQL 命令行执行ALTER USER ‘root’@’localhost’ IDENTIFIED BY ‘新密码’;，刷新权限FLUSH PRIVILEGES;。
三、数据库导入失败（SQL 文件过大或语法错误）
- 解决办法：
- 拆分大型 SQL 文件（使用 Navicat 的 “分割 SQL 文件” 功能），分多次导入。
- 调整 MySQL 配置：my.ini中设置max_allowed_packet = 64M（增大数据包限制），重启 MySQL。
- 检查 SQL 文件是否包含与 MySQL 版本不兼容的语法（如 MySQL 5.7 不支持GENERATED ALWAYS语法，需修改为兼容写法）。
四、项目缓存导致配置不生效（如数据库账号修改后仍连接失败）
- 解决办法：
- 清除项目缓存（如 Laravel 框架执行php artisan cache:clear、php artisan config:clear）。
- 删除缓存文件目录（如 ThinkPHP 的runtime/cache、runtime/session目录）。
- 若使用 OPcache，在php.ini中关闭opcache.enable = 0，或重启 PHP 服务刷新缓存。
五、第三方扩展依赖缺失（如GD库未安装导致图片处理失败）
- 解决办法：
- 集成环境中勾选对应扩展（PHPStudy 中 “软件管理”→“PHP”→“设置”→“扩展” 勾选gd2）。
- Linux 手动安装：sudo apt-get install php7.4-gd（根据 PHP 版本调整）。
- 验证扩展是否生效：创建phpinfo.php文件（内容<?php phpinfo(); ?>），访问页面确认扩展已加载。