Ionic打包出现无限白屏求助：执行ionic cordova build android后无限白屏

Hey there, sorry to hear you're stuck with that infinite white screen after building your Ionic Android app—this is a super common headache but totally fixable with some targeted checks. Let’s walk through the most likely causes and fixes step by step:

The white screen usually hides an underlying error that’s crashing your app’s runtime. Grab the full debug log using:

adb logcat

Or use Android Studio’s Logcat panel, then filter for tags like Ionic, Cordova, or WebView. Look for red error lines—common culprits include:

• Uncaught JavaScript exceptions (like ReferenceError for undefined variables)
• Failed resource loads (e.g., missing CSS/JS files due to wrong path)
• Permission denials stopping critical plugins from initializing

• Open config.xml and confirm the <content src="index.html" /> path is correct—typos here will prevent your app from loading the main page.
• Ensure you have <allow-navigation href="*" /> (for development; restrict it in production) to avoid navigation being blocked by the whitelist plugin.
• Verify ionic.config.json has the correct type field (e.g., angular, react, or vue)—mismatched framework types can break builds silently.

Stale build artifacts are often the culprit. Run these commands to clear everything out and rebuild fresh:

ionic cordova clean android
rm -rf node_modules
npm install
ionic cordova build android --prod --release

(Windows users: replace rm -rf node_modules with rd /s /q node_modules)

If the white screen only happens with --prod builds, the issue is likely with AOT compilation or minification. Try a non-production build first:

ionic cordova build android

If this works, you’re dealing with:

• Third-party libraries incompatible with AOT compilation
• Undeclared variables in your code (minifiers hate these)
• Broken lazy-loading configurations (common in Angular apps)

Use live reload mode to run the app and inspect the WebView:

ionic cordova run android -lcs

Then open Chrome and go to chrome://inspect—select your device’s app to access the DevTools Console. Here you’ll see exactly what’s failing in your JavaScript code, like a missing module or failed API call that’s freezing the app.

A recently added (or outdated) Cordova plugin might be conflicting with your Ionic version. Try:

• Removing the last plugin you added: ionic cordova plugin rm <plugin-name> then rebuild
• Checking the plugin’s GitHub page to confirm it supports your current Ionic/Cordova version (e.g., Ionic 6 requires specific versions of cordova-plugin-whitelist)

Make sure the core WebView plugin is installed and configured:

ionic cordova plugin add cordova-plugin-whitelist

Also, check your AndroidManifest.xml to ensure JavaScript is enabled for the WebView (it should be by default, but sometimes builds mess this up).

内容的提问来源于stack exchange，提问作者Eve-Sama