laravel 10 本身安装不报路径错误，所谓“路径错误”实为运行时分页url生成异常或命令行环境配置问题；需区分处理：一是laravel命令未识别，需配置composer全局bin路径；二是分页跳转丢失路由前缀，应使用withpath()或paginator::currentpathresolver()显式指定路径；三是app_url配置错误或未清缓存；四是web服务器子目录部署未正确传递script_name或request_uri。
Laravel 10 安装本身不直接报“路径错误”，但你遇到的所谓“路径错误”，大概率是安装完成后运行时出现的 URL 生成异常（比如分页跳转到 /page/2 却变成 /page/2 而不是预期的 /admin/users?page=2），或是命令行执行 laravel new 失败提示路径找不到——这两类问题根源完全不同，需分开处理。
一、laravel 命令提示 “command not found”
这不是 Laravel 项目的问题，而是 Composer 全局 bin 目录没被系统识别：
- 运行
composer global list | grep laravel/installer，确认是否已安装 installer - 查实际 bin 路径：
composer global config bin-dir（常见为~/.composer/vendor/bin或~/.config/composer/vendor/bin） - 把该路径加进 shell 配置文件（
~/.zshrc或~/.bashrc）：export PATH="$HOME/.composer/vendor/bin:$PATH" - 执行
source ~/.zshrc（或对应配置），再试laravel --version - 若仍失败，手动重装：
composer global require laravel/installer，并确保 PHP 版本 ≥8.1
二、安装后分页链接路径错乱（最常见“路径错误”）
典型表现：访问 /admin/posts，分页却跳到 /page/2 或 /?page=2，丢失前缀。这是因为分页器默认只读当前请求路径，不继承路由上下文：
- 控制器中用
withPath()显式指定基础路径：$posts = Post::paginate(10)->withPath('/admin/posts'); - 全站统一前缀？在
AppServiceProvider@boot中设置：Paginator::currentPathResolver(fn () => url('/news')); - API 返回 JSON 分页时路径异常？确保 API 路由用了
prefix('api')，且没在中间件里篡改 Request 实例 - 部署在子目录（如
https://example.com/myapp）？必须设对APP_URL=https://example.com/myapp，并启用TrustProxies中间件信任X-Forwarded-Proto等头
三、.env 配置导致的“伪路径错误”
修改了 APP_URL 却没清缓存，Laravel 仍按旧值生成 URL：
- 改完
.env后必须立即执行：php artisan config:clear && php artisan cache:clear - 检查
APP_URL是否带尾部斜杠（https://example.com/✅，https://example.com❌）——Laravel 会自动补，但部分代理环境可能出错 - 本地开发用
php artisan serve时，APP_URL应设为http://127.0.0.1:8000，不能写localhost（部分浏览器不认）
四、服务器部署路径未适配（Nginx/Apache）
应用放在子目录（如 /var/www/html/myapp），但 Web 服务器没正确传递路径信息：
- Nginx：确保
fastcgi_param SCRIPT_NAME '';不被错误覆盖；推荐用try_files $uri $uri/ /index.php?$query_string; - Apache：确认
.htaccess存在且RewriteBase /myapp已设置（如果部署在子目录） - 无论哪种服务器，都应在
public/index.php顶部临时加一行：die($_SERVER['REQUEST_URI']);，看真实传入路径是否含子目录前缀
