iOS 導航欄隱藏導致邊緣滑動返回 Bug 分析

現象

三頁面 ①→②→③，① 隱藏導航欄，②③ 顯示。邊緣滑動返回時：
1. ② 滑動未完成彈回，導航欄消失。
2. 重新進入 ②→③，③ 標題變為 ② 標題，返回按鈕失效，導航欄錯亂。

根因

導航欄狀態不一致 + 互動式轉場未完成時的狀態恢復缺陷。iOS 7+ 邊緣滑動返回 (`interactivePopGestureRecognizer`) 在轉場過程中會臨時調整導航欄透明度/隱藏，若轉場取消 (手勢釋放未超過閾值)，導航控制器未能正確恢復子控制器的導航欄狀態 (`prefersNavigationBarHidden`/`navigationBarHidden`)。

解決方案

1. 統一在 `viewWillAppear`/`viewWillDisappear` 設置導航欄狀態，而非 `viewDidLoad`：

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    self.navigationController.navigationBarHidden = YES; // 或 NO
}
- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    // 可選：離開時恢復預設，避免影響下一頁
    // self.navigationController.navigationBarHidden = NO;
}

2. 禁用邊緣滑動返回 (若不需要)：

self.navigationController.interactivePopGestureRecognizer.enabled = NO;

3. 自定義轉場協調器 (進階)：實現 `UINavigationControllerDelegate`，在 `navigationController:animationControllerForOperation:` 返回自定義動畫器，完全控制導航欄動畫。

最佳實踐

• **全局一致**：要麼所有頁面都隱藏導航欄 (自定義導航欄)，要麼都顯示系統導航欄並統一管理隱藏邏輯。
• **基類封裝**：建立 `BaseViewController`，在 `viewWillAppear` 根據屬性 `shouldHideNavBar` 統一設置，子類只需覆寫該屬性。
• **iOS 13+**：使用 `UINavigationBarAppearance` 配置外觀，避免舊 API 兼容性問題。

參考

搜索「iOS 導航欄隱藏 邊緣滑動返回 Bug」可見大量類似案例與開源解決方案 (如 `FDFullscreenPopGesture`、`ZFNavigation` 等庫)。