ガイド一覧Developer Guides (Japanese with English summaries)
開発の現場で役立つ実践的な解説記事をまとめています。ツールの使い方だけでなく、 背景知識や落とし穴も含めて解説しています。
Practical how-to articles for developers. Each guide is written in Japanese with an English TL;DR and summary section.
エラー解決Error resolution
よく遭遇するエラーの原因切り分けと対処。
JSONの Unexpected token エラーを直す
Fix JSON Unexpected token errors
position N の読み方、末尾カンマ・シングルクォート・BOM・NaN など主要原因の対処を体系化。
Base64デコードで日本語が文字化けする原因と対処
Fix garbled text when decoding Base64
btoa/atobのLatin-1制限とTextEncoder/TextDecoderを使ったUTF-8安全な実装。Base64URLも解説。
npm ERESOLVE エラーの原因と解決
Fix npm ERESOLVE errors
peer dependency 競合の読み方、overrides での固定、--legacy-peer-deps の是非。
認証・セキュリティAuth & Security
JWT・OAuth・HTTPステータスなど認証/認可まわり。
JWTの署名検証に失敗する原因と対処
Fix JWT signature verification failed
鍵不一致・alg不一致・kid解決失敗・aud/iss/exp の5原因から切り分け。Node/Python/Goの実装も。
HTTP 401 と 403 の違い・使い分け
HTTP 401 vs 403
認証エラー(401)と認可エラー(403)の正しい使い分け。WWW-Authenticate ヘッダとRFC 9110の定義。
JWTの有効期限切れを確認する方法
Checking JWT expiry
exp/iat/nbfクレームの読み方、タイムゾーンの罠、401時の対処フローを実例つきで解説。
DB・データ構造Database & Data
SQL・JSON Schema・UUID などデータ設計。
SQL GROUP BY と ORDER BY の順序・使い分け
SQL GROUP BY vs ORDER BY
書き順と評価順、SELECT 列の制約、PostgreSQL/MySQL/BigQuery の挙動差を整理。
UUID v4とv7の違い - いつどちらを使うべきか
UUID v4 vs v7
DBプライマリキー性能、ULIDとの比較、使い分け指針をビット構造図つきで解説。
JSON Schemaで型を保証する基本
JSON Schema basics
required / enum / additionalProperties の使い分けとAjvでの検証、CI組込みまで。
ネットワーク・HTTPNetworking & HTTP
CORS・TCPレベルのエラー切り分け。
CORS プリフライトで 400/403 が返る原因と対処
Fix CORS preflight 400/403
OPTIONS ルーティング欠落・認証ミドルウェア・ヘッダ不足の3原因別フィックス。Express/Nginx例つき。
ECONNREFUSED と ETIMEDOUT の違い・切り分け
ECONNREFUSED vs ETIMEDOUT
TCPレベルでの差、切り分けコマンド、Docker/Lambda で頻出する原因を整理。
CORSエラーの原因と正しい直し方
Diagnosing and fixing CORS errors
preflight / credentials の違い、Express/Nginx の正しい設定、よくある誤った対処を整理。
バージョン管理・開発フローVCS & Dev Workflow
Git・正規表現・タイムスタンプなど開発の基礎。
正規表現のLookbehindはどのブラウザで使える?
Regex lookbehind browser support
Safari 16.4 で対応。iOS 16.3 以前への配信時の代替パターンと実害ケース。
git push rejected (non-fast-forward) の直し方
Fix git push rejected non-fast-forward
pull --rebase / merge / --force-with-lease の使い分け。共同作業での事故回避。
UNIX timestamp 変換と落とし穴
UNIX timestamp conversion pitfalls
秒/ミリ秒の見分け方、タイムゾーンの扱い、言語別実装、2038年問題まで整理。
正規表現の実例集
Practical regex examples
郵便番号・メール・電話番号・URL抽出など、日本でよく使うパターンをコピペできる形で集めました。
ツール比較・選定Tool selection & comparison
開発ツールの選び方と比較。