🧒

CloudflareでPWAを作る際にハマったService Worker Blob問題とiOS/Android

に公開
2026/04/29

こんにちは、ちゃつです。
家族向けPWA「タスクマスター」をCloudflare Workers + KV + Pagesで構築したとき、Service Workerの通知がiOS/Androidで一切届かないという問題に詰まりました。

TL;DR

  • Service WorkerをBlob URLで登録するとiOS/Androidでプッシュ通知が届かない
  • sw.jsを独立ファイルに分離してルートパスで配信することで解決
  • setIntervalはバックグラウンドで止まる。タイマー処理はWorker Cron Triggersに移譲する

構成

  • フロントエンド: 単一HTMLファイル(Cloudflare Pagesにデプロイ)
  • バックエンド: Cloudflare Workers + KV(データ永続化・同期・Push通知)
  • 月額コスト: 家族数人の利用なら無料枠で収まる

コーディングは主にAIエージェントが担当し、設計の方向性を指示しながらバージョンを重ねています。v3.1〜v3.5で本記事を書き、v7で追記しています。

アーキテクチャ

各コンポーネントの役割

コンポーネント 役割
Cloudflare Pages HTMLファイルのホスティング
Cloudflare Workers REST API(データ取得・保存・Push配信)
Cloudflare KV 家族データのJSON永続化
Service Worker Push通知受信・オフラインキャッシュ
localStorage 端末ごとのキャッシュ(オフライン対応)

KVのデータ設計

family:{CODE} → {
  tasks: [...],
  rewards: [...],
  points: number,
  parentPin: string,
  ...
}

家族コード(6桁)をキーとしてJSONを丸ごと保存。KVの無料枠(書き込み1,000回/日・読み取り10万回/日)で余裕で収まります。

機能一覧

タスク管理

  • カテゴリ: study / chore / health / hobby / other
  • ポイント: low=5pt / medium=10pt / high=20pt
  • テンプレートからクイック追加
const TEMPLATES = [
  { title: '国語の見開きワーク1ページ', category: 'study', priority: 'medium', icon: '📖', studyAmount: 1 },
  { title: '風呂を洗う',               category: 'chore', priority: 'medium', icon: '🛁' },
];

ごほうびシステム

rewards: [
  { title: 'ゲーム30分延長', cost: 10,  icon: '🎮' },
  { title: '好きなおやつ',   cost: 600,  icon: '🍰' },
]

交換時はリアルタイムで保護者にPush通知が飛びます。

クラウド同期

家族コード(6桁)で複数端末を紐付け、30秒ポーリングで同期。タスク完了時は即時Push。


Service Worker Blob問題:iOSとAndroidで通知が届かない

失敗パターン:Blob URLでの登録

// NG: Blob方式 → iOS SafariやAndroid Chromeで通知が届かない
const blob = new Blob([swCode], { type: 'application/javascript' });
const swUrl = URL.createObjectURL(blob);
navigator.serviceWorker.register(swUrl);

iOS SafariはBlobからのService Worker登録を信頼しないという仕様上の制約です。ブラウザのDevToolsでは登録成功に見えますが、実際にはPush通知イベントが発火しません。

解決:sw.jsを独立ファイルに分離

// OK: 独立ファイルからの登録
navigator.serviceWorker.register('./sw.js');

sw.jsの構成(抜粋)

const CACHE_VERSION = 'v3.5.0';

self.addEventListener('push', event => {
  const data = event.data?.json() ?? {};
  event.waitUntil(
    self.registration.showNotification(data.title || '通知', {
      body: data.body || '',
      icon: '/icon.png',
    })
  );
});

通知スケジュール(Cloudflare Workers Cron Triggers)

# wrangler.toml
[triggers]
crons = ["0 22 * * *", "0 11 * * *"]
# UTC 22:00 = JST 07:00 / UTC 11:00 = JST 20:00
時間 送信先 内容
毎朝 7:00 子ども 今日のタスク一覧
毎晩 20:00 子ども 全完了→おめでとう / 未完了→残り件数
毎晩 20:00 保護者 全完了時のみ通知
タスク全完了時 保護者 リアルタイム
ごほうび交換時 保護者 リアルタイム

バージョンフォルダ方式(AI開発のルール)

子供タスクアプリ/
├── v3/
├── v3.1/
├── v3.4/      ← 安定版(触らない)
└── v3.5/      ← 作業中

「稼働中のディレクトリを直接触らない」がAIエージェントと開発する上での最大の教訓です。AIエージェントの設定ファイルにこのルールを書いておくと、次のセッションでも自動的に守ってくれます。

デプロイ方法

cd taskmaster-worker
wrangler deploy

cp taskmaster-v3.html taskmaster-pages/index.html
wrangler pages deploy taskmaster-pages --project-name=taskmaster

無料枠の目安

リソース 無料枠 家族利用の目安
Worker リクエスト 10万/日 余裕
KV 読み取り 10万/日 余裕
KV 書き込み 1,000/日 余裕
Pages 帯域 無制限 —

月額0円で運用できています。


v7追記:setIntervalはバックグラウンドで止まる

// NG: アプリを閉じると止まる
setInterval(() => { checkReminders(); }, 60000);

スマホでアプリを閉じた瞬間にJavaScriptが停止します。

解決:Worker Cronを毎分実行にする

[triggers]
crons = ["* * * * *"]
const jstNow = new Date(Date.now() + 9 * 60 * 60 * 1000);
const currentTime = String(jstNow.getUTCHours()).padStart(2, '0') + ':' + String(jstNow.getUTCMinutes()).padStart(2, '0');

const reminderTasks = todayTasks.filter(t =>
  t.reminderTime === currentTime && !(t.completedDates && t.completedDates.includes(today))
);

for (const task of reminderTasks) {
  await sendPushToFamily(env, familyCode, {
    targetRole: 'child',
    title: '⏰ タスクリマインダー',
    body: `「${task.title}」をやる時間だよ!`,
    tag: 'reminder-' + task.id,
  });
}

全タスク完了通知をPUT /api/dataに追加

const allDone = todayTasks.length > 0 &&
  todayTasks.every(t => t.completedDates && t.completedDates.includes(today));

if (allDone && newData.allDoneNotifiedDate !== today) {
  newData.allDoneNotifiedDate = today;
  await env.TASKMASTER_KV.put(`family:${code}`, JSON.stringify(newData));
  sendPushToFamily(env, code, {
    targetRole: 'parent',
    title: '🎉 全タスク完了!',
    body: `今日のタスクを全部クリアしました!💎 ${newData.points}pt 🔥 ${newData.streakDays}日連続`,
    tag: 'all-done',
  }).catch(e => console.error(e));
}

v7追記:TWA(Android APK化)のNotification API問題(未解決)

TWA(Trusted Web Activity)でラップしたAPKで 'Notification' in window が false になる問題が発生しました。assetlinks.jsonの設定・Chromeキャッシュのクリア・APK再インストールをすべて試しましたが、現時点で解決できていません。

同じ現象に遭遇して解決した方がいれば、コメントで教えていただけると助かります。

v10追記:UI/UX全面リニューアルとE2EE暗号化

v10(2026-04-15)で大幅にリニューアルしました。

UI/UXの変更:

  • iOS風タブ4構成(ホーム/スケジュール/ごほうび/設定)
  • ダークモード対応(prefers-color-scheme: dark)
  • 保護者PIN認証がインライン展開に(画面遷移なし)
  • 直近テスト警告カード + カウントダウン表示
  • 同条件タスクのグルーピング(「全日付に適用」)

セキュリティの変更(v9〜):

  • E2EE暗号化(AES-256-GCM、PBKDF2鍵導出)
  • PINハッシュ化(SHA-256)
  • データ削除エンドポイント(PIN認証付き)
  • プライバシーポリシーページ追加

v3.5→v7→v10と進む中で、「家族で使うPWA」としてかなり実用的なレベルになりました。

今後の課題

  • TWAのNotification API問題の調査継続
  • 複数子供への対応(現状1ユーザーID前提の設計)
  • KVからD1(SQLite)への移行検討

まとめ

  • Service WorkerはBlobではなく独立ファイルで登録する
  • バックグラウンド通知はWorker Cronで処理する
  • TWAのNotification APIは現時点で未解決

参考になれば幸いです。

※この記事は、noteで公開した記事をZenn向けに技術詳細に振り切った記事です。
https://note.com/tyatu/n/ncf2f84093e5b

Discussion