Flutter PWA移动端Chrome桌面模式显示空白页求助

• Flutter应用在Android、iOS原生端运行正常，部署为PWA后，电脑端浏览器、移动端普通模式均可正常加载，但在Android端Chrome开启「桌面站点」选项时页面空白白屏，这是唯一异常场景
• 已安装的PWA运行正常，iOS设备无此问题，仅Android端异常

Flutter版本信息 #

Flutter 3.24.3 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 2663184aa7 (3 weeks ago) • 2024-09-11 16:27:48 -0500
Engine • revision 36335019a8
Tools • Dart 3.5.3 • DevTools 2.37.3

/web/index.html 配置 #

<!DOCTYPE html>
<html>
<head>
  <!--
    If you are serving your web app in a path other than the root, change the
    href value below to reflect the base path you are serving from.

    The path provided below has to start and end with a slash "/" in order for
    it to work correctly.

    For more details:
    * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base

    This is a placeholder for base href that will be replaced by the value of
    the `--base-href` argument provided to `flutter build`.
  -->
  <base href="$FLUTTER_BASE_HREF">

  <meta charset="UTF-8">
  <meta content="IE=Edge" http-equiv="X-UA-Compatible">
  <meta name="description" content="*****">
  <meta name="viewport" content="width=device-width, initial-scale=1">

  <!-- iOS meta tags & icons -->
  <meta name="apple-mobile-web-app-capable" content="yes">
  <meta name="mobile-web-app-capable" content="yes">
  <meta name="apple-mobile-web-app-status-bar-style" content="black">
  <meta name="apple-mobile-web-app-title" content="*****">


  <link rel="apple-touch-icon" href="icons/apple-touch-icon.png">

  <!-- Favicon -->
  <link rel="shortcut icon" type="image/x-icon" href="favicon.ico"/>
  <link rel="icon" type="image/x-icon" href="favicon.ico"/>

  <title>******</title>
  <link rel="manifest" href="manifest.json">

  <script>
    // The value below is injected by flutter build, do not touch.
    const serviceWorkerVersion = null;
  </script>
  <!-- This script adds the flutter initialization JS code -->
  <script src="flutter.js" defer></script>
</head>
<body>
  <div id="fb-root"></div>

  <script>
    window.addEventListener('load', function(ev) {
      // Download main.dart.js
      _flutter.loader.loadEntrypoint({
        serviceWorker: {
          serviceWorkerVersion: serviceWorkerVersion,
        },
        onEntrypointLoaded: function(engineInitializer) {
          engineInitializer.initializeEngine().then(function(appRunner) {
            appRunner.runApp();
          });
        }
      });
    });
  </script>
</body>
</html>

/web/manifest.json 配置 #

{
    "name": "***",
    "short_name": "***",
    "start_url": "./index.html",
    "display": "standalone",
    "background_color": "***",
    "theme_color": "***",
    "description": "***",
    "orientation": "portrait-primary",
    "prefer_related_applications": false,
    "icons": [
        {
            "src": "icons/android-chrome-192x192.png",
            "sizes": "192x192",
            "type": "image/png"
        },
        {
            "src": "icons/android-chrome-512x512.png",
            "sizes": "512x512",
            "type": "image/png"
        },
        {
            "src": "icons/android-chrome-192x192.png",
            "sizes": "192x192",
            "type": "image/png",
            "purpose": "maskable"
        },
        {
            "src": "icons/android-chrome-512x512.png",
            "sizes": "512x512",
            "type": "image/png",
            "purpose": "maskable"
        }
    ]
}

• 优化viewport适配：当前viewport仅设置基础属性，桌面站点模式下浏览器模拟桌面分辨率可能导致渲染容器尺寸异常。补充缩放限制，修改为：

  <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no">
  

• 调整manifest的display属性：当前display: standalone在桌面站点模式下可能触发Chrome的适配冲突，尝试改为display: browser，让应用以标签页模式渲染。
• 添加基础样式兜底：在index.html的head中加入CSS，确保渲染容器占满视口，避免尺寸塌陷：

  <style>
    html, body {
      width: 100%;
      height: 100%;
      margin: 0;
      padding: 0;
      overflow: hidden;
    }
  </style>
  

• 切换渲染模式：默认的canvaskit渲染可能在桌面站点模式下存在兼容性问题，执行flutter build web --web-renderer html重新部署验证。
• 排查缓存与资源加载：在Chrome开发者工具中清空缓存，查看Network面板确认是否有资源加载失败，Console面板是否有JS报错。
• 调试桌面站点模式：通过chrome://inspect连接Android设备，查看桌面站点模式下的页面元素状态与控制台输出，定位具体异常点。

内容的提问来源于stack exchange，提问作者Gopika Singh