在 macOS 上透過 Homebrew 安裝 Nginx (`brew install nginx`) 後,PHP 檔案正常執行,但靜態資源 (圖片、CSS、JS) 卻回傳 403 Forbidden。經排查發現,Nginx 執行用戶 (通常為 `www` 或 `_www`) 無法遍歷父目錄,導致無法讀取靜態檔案。根因在於家目錄 (`/Users/username`) 缺少「其他用戶執行權限 (o+x)」。
Nginx worker process 以非 root 用戶運行,需對 從根目錄到網站根目錄的完整路徑 具備 執行權限 (x) 才能遍歷目錄結構讀取檔案。
# 檢查關鍵目錄權限
ls -ld /Users /Users/han /Users/han/Documents /Users/han/Documents/git /Users/han/Documents/git/msg/web/public
# 典型輸出顯示 Documents 缺少 o+x
drwx------+ 12 han staff 384 4 25 10:00 /Users/han/Documents
# 為「其他用戶」添加執行權限 (o+x) 於缺失目錄
chmod o+x /Users/han/Documents
# 若上層目錄亦缺失,同樣補充
chmod o+x /Users/han
chmod o+x /Users/han/Documents/git
# ... 依此類推至網站根目錄
一行 `chmod o+x` 解決 macOS Nginx 靜態檔案 403 疑難雜症,根治權限遍歷機制誤解。