macOS下Yii跳转路径失效主因是环境链路问题：Web服务器未启用重写（如Apache缺AllowOverride All或Nginx缺try_files）、urlManager配置错误或被覆盖、反代未透传X-Forwarded-Proto头、模块未注册（如gii未进bootstrap）、URL后缀导致路由不匹配。
macOS 下 Yii 跳转路径失效，通常不是框架本身“跳不动”，而是请求在抵达 Yii 前就卡在了环境链路上。重点排查 Web 服务器配置、URL 美化规则、代理头传递、模块注册和静态资源路径这五个环节。
Web 服务器未启用重写（最常见）
Yii 的友好 URL（如 /post/view/123）依赖 Apache 或 Nginx 开启 URL 重写。若直接访问 index.php?r=post/view&id=123 正常，但去掉 index.php 就 404，说明重写没生效。
- Apache：确认 .htaccess 文件存在且启用 AllowOverride All；检查是否加载 mod_rewrite
- Nginx：确保 server 块中包含标准重写规则，例如：
location / {
try_files $uri $uri/ /index.php?$args;
} - macOS 自带 Apache（如用 MAMP）：默认不读取项目根目录的 .htaccess，需手动在 httpd.conf 中为对应目录配置 <Directory> 段落
urlManager 配置未生效或被覆盖
即使服务器支持重写，Yii 的 urlManager 组件也必须正确启用并加载。常见误操作是把配置写错位置或被条件逻辑跳过。
- 确认配置位于 config/web.php 的 components 数组内，不是 params 或 bootstrap
- 检查是否启用了 enablePrettyUrl 和 showScriptName：
'urlManager' => [
'enablePrettyUrl' => true,
'showScriptName' => false,
] - 多个配置文件（如 main-local.php）可能覆盖了 urlManager，用 var_dump(Yii::$app->urlManager) 在任意 action 中验证实际加载值
反向代理/CDN 导致协议判断错误
在 macOS 上本地跑 Nginx + PHP-FPM，或使用 Docker、Valet、Laravel Homestead 等开发环境时，若 Yii 判断当前是 HTTP 却生成 HTTPS 跳转链接（或反之），大概率是 X-Forwarded-Proto 头未透传或未识别。
- 确保 Web 服务器（如 Nginx）转发请求时设置了：
proxy_set_header X-Forwarded-Proto $scheme; - Yii 需显式信任该头，在 web.php 中添加：
'request' => [
'trustedHosts' => ['^127\.0\.0\.1$'],
'secureHeaders' => ['X-Forwarded-Proto'],
] - 避免在代码中硬写 https://，统一用 Yii::$app->request->getAbsoluteUrl() 或 Url::to()
Gii 或其他模块路由 404（实为未注册）
访问 /gii 返回 404（不是 403），基本可断定模块根本没加载——不是权限问题，是路由压根没注册。
- 检查 modules 是否在 config/web.php 的顶层数组中定义，且拼写准确：
'modules' => [
'gii' => 'yii\gii\Module',
] - 确认 gii 已加入 bootstrap 数组（尤其高级模板）：
'bootstrap' => ['log', 'gii'], - macOS 上若启用了 URL 后缀（如 'suffix' => '.html'），必须访问 /gii.html 才能匹配，或临时禁用 suffix 测试
