深掘り– category –
**本線を一周した人向け。** roadmap.sh のコースを1つ選んで、その中を細かく潰していく記録。**順路ではありません。** 必要になったコースだけ読んでください。
-
React 深掘り
SSRとSSGのフレームワーク — SNSに貼るとタイトルが出ない
Viteで作ったReactアプリをビルドして配信し、curlでHTMLの中身を見ると 空の root 要素(div) しか入っていない。検索エンジンやSNSのクローラが見ているのはそれです。この記事では ~/ssrlab を新しく作り、まず症状をcurlで目に見せます。そのうえでCSR/SSG/SSR/ISRを「いつHTMLを作るか」の一本の軸で整理し、SSG(ビルド時に作る)を実際にやってcurlに本文が入るところを確認します。さらにExpressとrenderToStringで小さなSSRサーバーを自分で書き、フレームワークが何を代行しているのかを手で確かめます。山場はハイドレーションのズレで、new Date() と window を使ったコードでわざと警告とクラッシュを出してから直します。最後にNext.js・Remix・Astro・TanStack Startを同じ軸で対比し、SSRの代償と「とりあえずNext.js」をやめる判断表まで書きます。 -
React 深掘り
Reactのルーティング — リロードで最初の画面に戻る
ボタンで画面を切り替えるReactアプリを作ったら、リロードで最初に戻り、URLを共有できず、戻るボタンも効かなくなった。VMの ~/routelab で、まず素のReactでその3つの症状を実際に出す。次に history.pushState と popstate を手で書いて「ルーターが代わりにやっていること」を確かめてから React Router を入れ、Link と a タグの違いをNetworkタブで見る。山場はビルド後の本番配信で /users/1 を直接開くと404になるところで、nginx の try_files を設定ファイルの全文で示して直す。さらに loader で遷移前に取る形と useEffect のウォーターフォールを比べ、同じ画面を TanStack Router で書き直して、存在しないパスへのリンクが tsc で落ちるところまで確かめる。最後に何を選ぶかの判断。 -
React 深掘り
GraphQLクライアント — 一覧を出すのにAPIを4回叩く
一覧画面を1枚出すために、REST のエンドポイントを4回、多いときは21回叩いていた。そのうえ1件70項目も返ってきて、使うのは2項目だけだった。この記事では外部の公開APIを一切使わず、その「取りすぎ」と「足りない」を再現する小さな REST API を Express で自分で立て、転送量とリクエスト回数を実測する。次に graphql-yoga で GraphQL サーバーを自分で書き、まず curl の POST 1本だけで叩いて、同じ表で数字を比べる。そのうえで React 側に urql を入れ、ドキュメントキャッシュの素直さと限界を Network タブで確認する。Relay は思想が違うので、コンパイラを実際に走らせて「スキーマ側の規約を要求される」ところまで見て、個人開発では重いと結論を出す。最後に「GraphQL を入れない理由のほうが多い」判断基準を残す。 -
React 深掘り
React NativeとExpo — 書けてもdivは無い
「Reactが書けるならスマホアプリも作れる」と言われて React Native を触ったら、最初の1画面で落ちました。div も span も p も無く、文字を View に直接書くと落ち、CSSファイルも無い。何が同じで何が違うのかを、実際に create-expo-app でプロジェクトを作り、手持ちのスマホの Expo Go で動かしながら1つずつ切り分けます。わざと落として原因を読み、カウンターを作り、位置情報の権限を「拒否」して分岐が無いと落ちることも確かめます。Expo と素の React Native の違い、そしてストア配布に何が要るのかという現実的な着地まで。この回だけは VM ではなく Windows 本体と実機で作業します。 -
React 深掘り
Reactのアニメーション — 動きを付けたらカクついた
フェードインを1つ足しただけで画面がカクついた。原因はライブラリではなく「どのプロパティを動かしたか」でした。この記事では、まず left と width を動かす版と transform と opacity を動かす版を同じ画面に並べ、DevTools の Performance タブでフレームレートとレイアウトの再計算回数を実際に測って比べます。そのうえで CSS の transition と @keyframes だけでどこまで書けるか、どこで足りなくなるか(消えるときのアニメーション)を再現し、そこで初めて Framer Motion・react-spring・GSAP を1つずつ入れます。時間で指定する道具と物理で指定する道具の止まり方の違い、GSAP を React で使うときの後片づけ、そして prefers-reduced-motion まで。~/anilab をポート5186で新しく作り、最後に消します。 -
システム設計 深掘り
レプリケーションとシャーディング — 書き込みは速くならない
書き込みが詰まったのでレプリカを2台足したのに、書き込みは1ミリ秒も速くなりませんでした。レプリケーションが分散するのは「読み」だけで、「書き」は primary 1台に集まったままだからです。この記事では MySQL を Docker Compose で primary 1台 + replica 2台立てて実際にレプリケーションを組み、読みを振り分けたときに primary の CPU がどう下がるかを docker stats で測ります。次にわざと遅延を作り、遅れたレプリカを読むと古い値が返ることを再現します。primary を停めてレプリカを昇格させ、昇格が自動ではないこと、古い primary を戻すと二重書き込みになることも手で確かめます。後半はシャーディングで、範囲・ハッシュ・一貫性ハッシュの3つの分け方を Node のスクリプトで実際に計算し、台数を1台増やしたときに何%のデータが引っ越すかを数えます。最後に2台に分けた MySQL で JOIN・トランザクション・採番が壊れるところまで再現して、全部消します。 -
システム設計 深掘り
指数バックオフとバルクヘッド — リトライが障害を長引かせる
落ちかけている相手に素朴なリトライを投げると、負荷が3倍になって復旧を邪魔する。この記事では Node.js で「呼ぶ側」と「呼ばれる側」を自分で書き、わざと壊して、到達回数を数えます。素朴なリトライ・指数バックオフ・ジッタの3つを実測で比べ、バックオフだけでは再送の波が揃ってしまうことを確かめます。さらに、遅い相手が全体のコネクションを食い潰す様子をバルクヘッド(同時実行数の隔離)で止め、nginx の upstream で primary を1台落として backup へ切り替わるところを見ます。最後に、全部止めずに古いデータを返す「縮退」を実装し、どの型をいつ入れるかの優先順位で締めます。作業は VM の中の ~/rellab で行い、終わったら全部消します。 -
システム設計 深掘り
イベント駆動アーキテクチャ — 機能を足すたび注文APIが壊れる
注文が入ったらメールを送り、在庫を減らし、売上集計を更新する。この3つを注文APIから順に呼ぶ形で作ったところ、メールサーバーを1つ落としただけで注文そのものが500になりました。この記事では同じ機能を Redis Streams のイベント形に組み替え、購読側を1つ落としても注文が通ること、機能を1つ足しても注文APIを1行も触らずに済むことを実測します。そのうえで代償を正面から測ります。全体の流れがどこにも書かれていないこと、相関IDが無いと追跡できないこと、注文直後にメール履歴がまだ無いこと、同じイベントが2回届くことを、わざと起こして確かめます。続いてコマンドとイベントの違い、指揮者を置く形と各自が反応する形を比べ、CQRSでは20万件の集計クエリと、イベントで更新しておいた集計テーブルの実行時間を並べます。最後にイベントソーシングを小さく実装し、再生が遅くなるところまで見てから「大半のアプリには要らない」と結論を書き、立てたものを全部消します。 -
システム設計 深掘り
サービスディスカバリと名前解決 — 相手のIPを書いたら翌日壊れた
サービスAの設定ファイルにサービスBのIPアドレスを書いたら、コンテナを作り直した翌日に全部つながらなくなりました。この記事では Docker Compose で小さなサービスを2つ立て、まず docker inspect でIPが実際に変わるところを見てから、IP直書きが壊れる瞬間を再現します。次にサービス名で呼ぶ形に直し、getent hosts でDNS解決を確かめます。そのうえで「DNSだけでは足りない」ことを、nginx が起動時に解決したIPを掴んだまま502を返し続けるところで実測し、resolver と TTL で直します。さらに Redis を登録簿にした小さなサービスレジストリを作り、SETEX と定期更新で登録し、片方を止めると登録が自動で消えるところを確認します。最後に nginx で入口を1つにまとめる API ゲートウェイとレート制限を作り、BFF の考え方まで触れて、立てたものを全部消します。 -
システム設計 深掘り
データストアの選び方 — 速いのはJOINをしていないから
「NoSQLは速い」と聞いて MongoDB に移し、3ヶ月後に自分でJOINを書いていました。データの持ち方は速さで選ぶものではなく、どう問い合わせるかで決まります。この記事では Docker Compose で MySQL・Redis・MongoDB を同時に立て、利用者・投稿・タグ・フォローという同じ題材を、キーバリュー・ドキュメント・リレーショナルの3つの形で実際に持ってみます。同じ問いを3つの形に投げ、取れるもの・取れないもの・何回問い合わせが要るかを数えます。さらに1000万行のテーブルを作り、1列だけ合計する問いで行単位に読む形の不利を EXPLAIN と実行時間で見せ、列指向が何をしているのかを被覆索引で再現します。最後にフォローを3段たどる問いを再帰CTEで書き、深さを1つ増やすだけで急に遅くなるところを実測して、グラフDBが要る場面と要らない場面を分けます。立てたものは全部消します。