Troubleshooting¶

Common issues¶

Headers not applied (iOS)¶

Cause: WKWebView may cache navigation requests and ignore headers on subsequent loads.

Solution: attach headers on the initial URLRequest and avoid using loadHTMLString for the first navigation. Use WKWebsiteDataStore.default() to persist cookies.

User forced to re-login each time¶

Cause: cookies not shared or session cleared.

Solution: ensure cookies are enabled and persisted (WKWebsiteDataStore.default() on iOS; CookieManager on Android). Do not clear data between navigations.

Redirect loop¶

Cause: silent login headers were not sent on the first load.

Solution: provide all headers on the initial request: Authorization, TRAVELN-EMAIL, TRAVELN-PHONE, TRAVELN-FIRST-NAME, TRAVELN-LAST-NAME.

Blank white screen¶

Cause: JavaScript disabled in the WebView.

Solution: enable JS (javaScriptEnabled / setJavaScriptEnabled(true)).