树莓派Chromium Kiosk模式下“Aw, Snap!”错误的成因及自动刷新方案

一、错误成因分析 #

针对树莓派Kiosk运行Angular打卡应用的场景，常见触发原因包括：

• 内存资源耗尽：树莓派内存容量有限，Angular应用若存在内存泄漏、未清理的组件缓存，或加载大量静态资源，长时间运行后会触发Chromium的内存保护机制，导致页面进程崩溃。
• GPU适配问题：默认开启的GPU加速在树莓派低性能GPU上容易出问题，尤其是应用包含复杂动画、Canvas或WebGL渲染时，GPU进程崩溃会引发页面报错。
• Chromium版本bug：旧版本Chromium针对ARM架构的适配存在稳定性缺陷，部分已知bug会导致无规律的页面崩溃。
• 网络异常：打卡应用依赖网络，网络中断后恢复时，Chromium的网络进程可能出现状态异常，触发页面崩溃。
• 前端代码问题：Angular应用中的未捕获错误、第三方依赖冲突、懒加载失败等，会直接导致渲染进程崩溃。

二、自动重新加载的可行方案 #

1. 优化启动参数+进程监控脚本 #

先通过参数降低崩溃概率，再用脚本监控并重启：

• 修改Kiosk启动脚本（通常在~/.config/lxsession/LXDE-pi/autostart），替换原有Chromium启动命令为：

  @chromium-browser --kiosk --noerrdialogs --disable-infobars --disable-session-crashed-bubble --disable-gpu --memory-pressure-offload=0 "你的打卡应用地址"
  

  这些参数的作用：关闭GPU加速避免硬件适配问题，禁用崩溃提示弹窗，减少内存回收导致的异常。

• 编写监控脚本chromium_monitor.sh：

  #!/bin/bash
  TARGET_URL="你的打卡应用地址"
  
  while true; do
    # 检查是否存在"Aw, Snap!"崩溃窗口
    CRASH_WINDOWS=$(xdotool search --name "Aw, Snap!" | wc -l)
    if [ "$CRASH_WINDOWS" -gt 0 ]; then
      # 关闭所有Chromium进程
      pkill chromium-browser
      # 延迟2秒后重启Kiosk
      sleep 2
      chromium-browser --kiosk --noerrdialogs --disable-infobars --disable-gpu "$TARGET_URL" &
    fi
    # 每10秒检查一次
    sleep 10
  done
  

  给脚本加执行权限：chmod +x chromium_monitor.sh，并在autostart里添加一行：@/home/pi/chromium_monitor.sh（替换成你的脚本路径）。

2. 利用Chromium内置恢复机制+自定义扩展 #

• 启用Chromium崩溃自动重载：在chrome://flags中找到Auto-reload on crash设置为启用，同时在启动参数中加入--enable-auto-reload，但这个功能在Kiosk模式下可能不稳定，建议配合扩展。
• 编写轻量Chrome扩展监听崩溃页面：
  创建manifest.json：

  {
    "manifest_version": 3,
    "name": "Kiosk AutoReload",
    "version": "1.0",
    "permissions": ["tabs"],
    "background": {
      "service_worker": "background.js"
    }
  }
  

  创建background.js：

  chrome.tabs.onUpdated.addListener((tabId, info, tab) => {
    // 检测崩溃页面的特征URL
    if (tab.url.includes("chrome-error://chromewebdata/")) {
      chrome.tabs.reload(tabId);
    }
  });
  

  把这个文件夹作为未打包扩展加载到Chromium，启动参数添加--load-extension=/home/pi/kiosk-reload-extension（替换成你的扩展路径）。

3. 基于健康检查的重启脚本 #

如果应用有健康检查接口，用脚本定时检测，异常则重启：

#!/bin/bash
APP_URL="你的打卡应用地址"
HEALTH_CHECK_URL="你的健康检查接口地址"

while true; do
  # 检查接口返回状态
  HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$HEALTH_CHECK_URL")
  if [ "$HTTP_CODE" -ne 200 ]; then
    pkill chromium-browser
    sleep 2
    chromium-browser --kiosk --noerrdialogs --disable-infobars "$APP_URL" &
  fi
  sleep 30
done

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