<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Next.js &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/category/next-js/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Wed, 11 Nov 2026 22:25:45 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://cfxlog.com/wp-content/uploads/2026/07/cfxlog-favicon-150x150.png</url>
	<title>Next.js &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>Next.js JWT認証の実装｜アクセストークンをメモリ管理・リフレッシュ並走バグを防ぐmutexパターン</title>
		<link>https://cfxlog.com/nextjs-jwt-memory-token-auth/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 12 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Next.js]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nextjs-jwt-memory-token-auth/</guid>

					<description><![CDATA[この記事は、Next.js + Django JWT認証シリーズのフロントエンド実装編です。設計の考え方は下記の記事で解説しています。 TypeScriptで実装します。ファイル名は lib/auth.ts として、認証 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Next.jsでJWTトークンをどこに保存すればいいか知りたい</li>



<li>複数リクエストが同時にリフレッシュを呼んでエラーになる問題を解決したい</li>



<li>401レスポンスを受け取ったときに自動でリトライする仕組みを作りたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事は、Next.js + Django JWT認証シリーズのフロントエンド実装編です。設計の考え方は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-django-jwt-auth-design/">Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</a>
						<span class="p-blogCard__excerpt">JWTをlocalStorageに保存していいのか不安 アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい XSSとCSRFを両方対策した設計の考え方を理解したい JW&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">TypeScriptで実装します。ファイル名は <code>lib/auth.ts</code> として、認証に関わる関数をすべてここにまとめます。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5423" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">アクセストークンをメモリに保持する</a></li><li class="rtoc-item"><a href="#rtoc-2">localStorageはセッションフラグだけに使う</a></li><li class="rtoc-item"><a href="#rtoc-3">CSRF トークンの取得</a></li><li class="rtoc-item"><a href="#rtoc-4">refreshToken() の並走対策（mutex）</a></li><li class="rtoc-item"><a href="#rtoc-5">apiFetch() で 401 を自動リトライする</a></li><li class="rtoc-item"><a href="#rtoc-6">ログイン・ログアウトの実装</a></li><li class="rtoc-item"><a href="#rtoc-7">ページ初期化時の認証復元（initializeAuth）</a></li><li class="rtoc-item"><a href="#rtoc-8">まとめ：この実装で防げること</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">アクセストークンをメモリに保持する</h2>



<p class="wp-block-paragraph">アクセストークンはモジュールスコープの変数に保存します。localStorageやsessionStorageを使わないことがXSS対策の核心です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// モジュールスコープの変数でメモリ管理する
let accessTokenInMemory: string | null = null;

export const getAccessToken = () => accessTokenInMemory;
export const setAccessToken = (t: string | null) => {
  accessTokenInMemory = t;
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// モジュールスコープの変数でメモリ管理する</span></span>
<span class="line"><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4"> = (</span><span style="color: #9CDCFE">t</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4">) </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">t</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">モジュールスコープの変数はページをリロードすると消えます。ただし、有効なリフレッシュCookieがあればページ初期化時に自動で復元されます。この仕組みは後述の <code>initializeAuth()</code> で実装します。</p>



<h2 id="rtoc-2"  class="wp-block-heading">localStorageはセッションフラグだけに使う</h2>



<p class="wp-block-paragraph">HttpOnly CookieはJavaScriptから読めないため、ログイン済みかどうかを確認する手段がありません。そこで「セッションが存在するかどうか」というboolean値だけをlocalStorageに保存します。トークン本体は絶対に保存しません。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>const SESSION_FLAG = 'has_session';

// ログイン時に呼ぶ
export const markSessionActive = () => {
  try { localStorage.setItem(SESSION_FLAG, '1'); } catch { /* ignore */ }
};

// ログアウト時に呼ぶ
export const clearSessionFlag = () => {
  try { localStorage.removeItem(SESSION_FLAG); } catch { /* ignore */ }
};

// ログイン済みかどうかのヒントとして使う
export const hasSessionFlag = (): boolean => {
  try { return localStorage.getItem(SESSION_FLAG) === '1'; } catch { return false; }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&apos;has_session&apos;</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログイン時に呼ぶ</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">markSessionActive</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">setItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&apos;1&apos;</span><span style="color: #D4D4D4">); } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #6A9955">/* ignore */</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログアウト時に呼ぶ</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">clearSessionFlag</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">removeItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">); } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #6A9955">/* ignore */</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログイン済みかどうかのヒントとして使う</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">hasSessionFlag</span><span style="color: #D4D4D4"> = (): </span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">getItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">) === </span><span style="color: #CE9178">&apos;1&apos;</span><span style="color: #D4D4D4">; } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">; }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">このフラグはUIの表示切り替え（ログイン状態の初期判定）に使うもので、実際のAPIリクエストの認証はメモリ上のアクセストークンで行います。</p>



<h2 id="rtoc-3"  class="wp-block-heading">CSRF トークンの取得</h2>



<p class="wp-block-paragraph">DjangoはCSRF保護が有効なため、POSTリクエストには <code>X-CSRFToken</code> ヘッダーが必要です。まずCookie からCSRFトークンを読む関数を用意し、次にCSRF Cookieを取得するエンドポイントを呼び出す関数を作ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// document.cookie からCSRFトークンを読む
const getCookie = (name: string): string | null => {
  const m = document.cookie.match(new RegExp(`(?:^|; )${name}=(&#91;^;&#93;*)`))
  return m ? decodeURIComponent(m&#91;1&#93;) : null
}

// ページ初期化時に1回だけ呼んでCSRF Cookieをセットする
export const fetchCsrfCookie = async () => {
  try {
    await fetch('/auth/csrf_cookie/', {
      method: 'GET',
      credentials: 'include',
    })
  } catch {
    // 広告ブロッカー等でブロックされる可能性があるため静かに失敗させる
  }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// document.cookie からCSRFトークンを読む</span></span>
<span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4"> = (</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">): </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">m</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">document</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">cookie</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">match</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">RegExp</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`(?:^|; )</span><span style="color: #569CD6">${</span><span style="color: #9CDCFE">name</span><span style="color: #569CD6">}</span><span style="color: #CE9178">=(&#91;^;&#93;*)`</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">m</span><span style="color: #D4D4D4"> ? </span><span style="color: #DCDCAA">decodeURIComponent</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">m</span><span style="color: #D4D4D4">&#91;</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">&#93;) : </span><span style="color: #569CD6">null</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ページ初期化時に1回だけ呼んでCSRF Cookieをセットする</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetchCsrfCookie</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;/auth/csrf_cookie/&apos;</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;GET&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    })</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 広告ブロッカー等でブロックされる可能性があるため静かに失敗させる</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<h2 id="rtoc-4"  class="wp-block-heading">refreshToken() の並走対策（mutex）</h2>



<p class="wp-block-paragraph">ここがこの実装の核心部分です。<code>ROTATE_REFRESH_TOKENS = True</code> の環境では、複数のリクエストが同時に <code>refreshToken()</code> を呼び出すと競合が起きます。</p>



<p class="wp-block-paragraph">対策は、進行中のリフレッシュリクエストをモジュールスコープ変数に保持し、2回目以降の呼び出しでは同じPromiseを返すことです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// 進行中のリフレッシュリクエストを保持する（mutexとして機能する）
let refreshingPromise: Promise&lt;boolean> | null = null;

export const refreshToken = (): Promise&lt;boolean> => {
  // 既に進行中なら同じPromiseを返す（新たにリクエストを送らない）
  if (refreshingPromise) return refreshingPromise;

  refreshingPromise = (async () => {
    try {
      const res = await fetch('/auth/jwt/refresh/', {
        method: 'POST',
        credentials: 'include', // HttpOnly Cookieをブラウザが自動送信
        headers: {
          'Content-Type': 'application/json',
          'X-CSRFToken': getCookie('csrftoken') ?? '',
        },
        body: JSON.stringify({}),
      });
      if (!res.ok) return false;
      const data = await res.json() as { access?: string };
      if (data?.access) setAccessToken(data.access);
      return !!data?.access;
    } catch {
      return false;
    } finally {
      // 成功・失敗にかかわらず次の呼び出しに備えてリセット
      refreshingPromise = null;
    }
  })();

  return refreshingPromise;
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// 進行中のリフレッシュリクエストを保持する（mutexとして機能する）</span></span>
<span class="line"><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4">&gt; | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4"> = (): </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4">&gt; </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 既に進行中なら同じPromiseを返す（新たにリクエストを送らない）</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4"> = (</span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;/auth/jwt/refresh/&apos;</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #6A9955">// HttpOnly Cookieをブラウザが自動送信</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">          </span><span style="color: #CE9178">&apos;Content-Type&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;application/json&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">          </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        },</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">body:</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">JSON</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">stringify</span><span style="color: #D4D4D4">({}),</span></span>
<span class="line"><span style="color: #D4D4D4">      });</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">ok</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">data</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">json</span><span style="color: #D4D4D4">() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">?: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> };</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">?.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">) </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> !!</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">?.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    } </span><span style="color: #C586C0">finally</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #6A9955">// 成功・失敗にかかわらず次の呼び出しに備えてリセット</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    }</span></span>
<span class="line"><span style="color: #D4D4D4">  })();</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">3つのリクエストが同時に401を受け取って <code>refreshToken()</code> を呼び出したとしても、実際にサーバーへ送るリフレッシュリクエストは1本だけになります。他の2本は同じPromiseを待つため、競合が起きません。</p>



<h2 id="rtoc-5"  class="wp-block-heading">apiFetch() で 401 を自動リトライする</h2>



<p class="wp-block-paragraph">APIリクエストのラッパー関数を実装します。401レスポンスを受け取ったら自動でリフレッシュし、元のリクエストを再実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL ?? '';

export async function apiFetch(input: string, init: RequestInit = {}) {
  const headers = new Headers(init.headers);
  const token = getAccessToken();
  if (token) headers.set('Authorization', `Bearer ${token}`);

  let res = await fetch(`${API_BASE_URL}${input}`, {
    ...init,
    headers,
    credentials: 'include',
  });

  // 401以外はそのまま返す
  if (res.status !== 401) return res;

  // アクセストークン切れ → リフレッシュしてリトライ
  const refreshed = await refreshToken();
  if (!refreshed) return res; // リフレッシュも失敗したら元の401を返す

  // 新しいアクセストークンで再リクエスト
  headers.set('Authorization', `Bearer ${getAccessToken()}`);
  return fetch(`${API_BASE_URL}${input}`, { ...init, headers, credentials: 'include' });
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">process</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">env</span><span style="color: #D4D4D4">.</span><span style="color: #4FC1FF">NEXT_PUBLIC_API_URL</span><span style="color: #D4D4D4"> ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">function</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">apiFetch</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">input</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">RequestInit</span><span style="color: #D4D4D4"> = {}) {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">headers</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Headers</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">token</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">token</span><span style="color: #D4D4D4">) </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">set</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;Authorization&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">`Bearer </span><span style="color: #569CD6">${</span><span style="color: #9CDCFE">token</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">);</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}${</span><span style="color: #9CDCFE">input</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  });</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 401以外はそのまま返す</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">status</span><span style="color: #D4D4D4"> !== </span><span style="color: #B5CEA8">401</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// アクセストークン切れ → リフレッシュしてリトライ</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">refreshed</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">refreshed</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">; </span><span style="color: #6A9955">// リフレッシュも失敗したら元の401を返す</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 新しいアクセストークンで再リクエスト</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">set</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;Authorization&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">`Bearer </span><span style="color: #569CD6">${</span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4">()</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}${</span><span style="color: #9CDCFE">input</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">, { ...</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4"> });</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">呼び出し側は通常の <code>fetch()</code> と同じ感覚で使えます。401ハンドリングを意識する必要がなく、コードがシンプルに保てます。</p>



<h2 id="rtoc-6"  class="wp-block-heading">ログイン・ログアウトの実装</h2>



<p class="wp-block-paragraph">ログインはDjoserの <code>/auth/jwt/create/</code> を呼び出します。アクセストークンをメモリに保存し、セッションフラグを立てます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>export const login = async (email: string, password: string) => {
  const res = await fetch(`${API_BASE_URL}/auth/jwt/create/`, {
    method: 'POST',
    credentials: 'include',
    headers: {
      'Content-Type': 'application/json',
      'X-CSRFToken': getCookie('csrftoken') ?? '',
    },
    body: JSON.stringify({ email, password }),
  });
  if (!res.ok) throw new Error('ログインに失敗しました');
  const data = await res.json() as { access: string };
  setAccessToken(data.access);
  markSessionActive();
  return data;
};

export const logout = async () => {
  try {
    await fetch(`${API_BASE_URL}/auth/logout/`, {
      method: 'POST',
      credentials: 'include',
      headers: { 'X-CSRFToken': getCookie('csrftoken') ?? '' },
    });
  } finally {
    // サーバー側の処理が失敗してもローカルはクリアする
    setAccessToken(null);
    clearSessionFlag();
  }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">login</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">email</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">password</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">) </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}</span><span style="color: #CE9178">/auth/jwt/create/`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&apos;Content-Type&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;application/json&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    },</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">body:</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">JSON</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">stringify</span><span style="color: #D4D4D4">({ </span><span style="color: #9CDCFE">email</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">password</span><span style="color: #D4D4D4"> }),</span></span>
<span class="line"><span style="color: #D4D4D4">  });</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">ok</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">throw</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Error</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;ログインに失敗しました&apos;</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">data</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">json</span><span style="color: #D4D4D4">() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> };</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #DCDCAA">markSessionActive</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">logout</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}</span><span style="color: #CE9178">/auth/logout/`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> { </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4"> },</span></span>
<span class="line"><span style="color: #D4D4D4">    });</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">finally</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// サーバー側の処理が失敗してもローカルはクリアする</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">clearSessionFlag</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">ログアウトは <code>try...finally</code> を使い、サーバー側のブラックリスト登録が失敗してもローカルのアクセストークンとセッションフラグは必ずクリアします。</p>



<h2 id="rtoc-7"  class="wp-block-heading">ページ初期化時の認証復元（initializeAuth）</h2>



<p class="wp-block-paragraph">ページをリロードするとメモリ上のアクセストークンが消えます。有効なリフレッシュCookieがあれば自動で復元できるよう、アプリ起動時に一度だけ呼ぶ初期化関数を用意します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>export const initializeAuth = async (): Promise&lt;void> => {
  try {
    // 1. CSRF Cookieを取得する（POSTリクエストに必要）
    await fetchCsrfCookie();
    // 2. リフレッシュCookieでアクセストークンを復元する
    await refreshToken();
  } catch (e) {
    console.warn('initializeAuth failed', e);
  }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">initializeAuth</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> (): </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">void</span><span style="color: #D4D4D4">&gt; </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 1. CSRF Cookieを取得する（POSTリクエストに必要）</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetchCsrfCookie</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 2. リフレッシュCookieでアクセストークンを復元する</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">e</span><span style="color: #D4D4D4">) {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">console</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">warn</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;initializeAuth failed&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">e</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">Next.jsのApp Routerを使っている場合、ルートの <code>layout.tsx</code> に配置した <code>AuthProvider</code> などのクライアントコンポーネントから <code>useEffect(() =&gt; { initializeAuth(); }, [])</code> で呼び出します。</p>



<p class="wp-block-paragraph">リフレッシュCookieが有効期限切れの場合は <code>refreshToken()</code> が <code>false</code> を返します。この場合はアクセストークンが復元されず、ユーザーは未ログイン状態になります。</p>



<h2 id="rtoc-8"  class="wp-block-heading">まとめ：この実装で防げること</h2>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>XSSによるトークン盗取</strong><br>アクセストークンはメモリのみ。リフレッシュトークンはHttpOnly Cookie。どちらもXSSスクリプトから直接読み出せない。</li>



<li><strong>CSRF攻撃</strong><br>アクセストークンはAuthorizationヘッダー送信のみ。リフレッシュCookieのパスは <code>/auth/</code> に限定されているため、API全体をCSRFで叩くことができない。</li>



<li><strong>リフレッシュの並走競合</strong><br>mutexパターンにより、同時に何本のリクエストが来ても実際のリフレッシュAPIは1本のみ実行される。</li>



<li><strong>アクセストークン期限切れによるエラー</strong><br><code>apiFetch()</code> が自動でリフレッシュ＆リトライするため、呼び出し側で期限切れを意識しなくてよい。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">バックエンド（Django）側の設定は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-simplejwt-djoser-setup/">Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</a>
						<span class="p-blogCard__excerpt">DjangoでJWT認証を実装したい SimpleJWTとDjoserをどう組み合わせるか知りたい 不要なエンドポイントを封鎖してセキュリティを高めたい この記事は、Next.js + Django J&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</title>
		<link>https://cfxlog.com/nextjs-django-jwt-auth-design/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 13 May 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[Next.js]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nextjs-django-jwt-auth-design/</guid>

					<description><![CDATA[JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。 この記事では、なぜその設計になるのかを理由から解説します。 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>JWTをlocalStorageに保存していいのか不安</li>

<li>アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい</li>

<li>XSSとCSRFを両方対策した設計の考え方を理解したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。</p>



<p class="wp-block-paragraph">この記事では、なぜその設計になるのかを理由から解説します。実装コードはバックエンド・フロントエンドで別記事に分けてあるので、この記事では「設計の考え方」に絞ります。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5418" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">JWTの保存場所は3種類ある</a></li><li class="rtoc-item"><a href="#rtoc-2">アクセストークンとリフレッシュトークンを分ける理由</a></li><li class="rtoc-item"><a href="#rtoc-3">認証フローの全体像</a></li><li class="rtoc-item"><a href="#rtoc-4">ROTATE_REFRESH_TOKENSが引き起こす並走リフレッシュ問題</a></li><li class="rtoc-item"><a href="#rtoc-5">バックエンド（Django）の実装</a></li><li class="rtoc-item"><a href="#rtoc-6">フロントエンド（Next.js）の実装</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">JWTの保存場所は3種類ある</h2>



<p class="wp-block-paragraph">JWTを保存できる場所は主に3つあり、それぞれセキュリティ特性が異なります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>localStorage</strong><br>JavaScriptから自由に読み書きできる。XSSが成立すると <code>localStorage.getItem()</code> 一行でトークンが盗まれる。</li>

<li><strong>HttpOnly Cookie</strong><br>JavaScriptから読み書きできない。ただしブラウザが同一オリジンへのリクエストに自動付与するため、CSRF攻撃の対象になりやすい。</li>

<li><strong>メモリ（JS変数）</strong><br>ページをまたいで持続しない。同じタブ内のJavaScriptからは参照できるが、localStorageのように永続化されないため露出範囲が限られる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">「HttpOnly Cookieが最も安全だから、全部そこに入れればいい」と思いたくなります。しかし、アクセストークンとリフレッシュトークンでは性質が大きく違うため、同じ保存先にまとめるのは最適解ではありません。</p>



<h2 id="rtoc-2"  class="wp-block-heading">アクセストークンとリフレッシュトークンを分ける理由</h2>



<p class="wp-block-paragraph">2種類のトークンには、用途と有効期限に大きな差があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン（有効期限: 15分）</strong><br>APIリクエストのたびに <code>Authorization: Bearer</code> ヘッダーに付けて送る。短命なので仮に流出しても被害期間が限定される。</li>

<li><strong>リフレッシュトークン（有効期限: 14日）</strong><br>アクセストークンが切れたときだけ使う。長命なので慎重に管理する必要がある。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この性質の差から、次の方針が導き出されます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン → メモリ（JS変数）</strong><br>短命なのでリロードで消えても問題ない。Authorizationヘッダーで送るため、Cookieのような自動付与によるCSRFリスクがない。</li>

<li><strong>リフレッシュトークン → HttpOnly Cookie（パス: /auth/ に限定）</strong><br>JavaScriptから読めないのでXSSで盗まれない。パスを <code>/auth/</code> に絞ることで <code>/api/</code> へのリクエストにはCookieが付かず、CSRF攻撃の対象面を最小化できる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">両方をHttpOnly Cookieに入れた場合と比べて、アクセストークンがヘッダー送信のみになるため、CSRFトークンによる保護が不要なリクエストの範囲が広がります。</p>



<h2 id="rtoc-3"  class="wp-block-heading">認証フローの全体像</h2>



<p class="wp-block-paragraph">設計を決めたら、次はフローを整理します。ログインからAPIアクセス、トークン更新、ログアウトまでの流れです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list">
<li><strong>ページ初期化</strong><br>CSRF Cookieを取得 → <code>/auth/jwt/refresh/</code> にリクエスト → ブラウザがHttpOnly Cookieを自動送信 → サーバーがアクセストークンを返す → メモリに保存する</li>

<li><strong>APIリクエスト</strong><br>メモリ上のアクセストークンを <code>Authorization: Bearer {token}</code> ヘッダーに付けて送信する</li>

<li><strong>401レスポンス時</strong><br>アクセストークンの有効期限切れ → <code>refreshToken()</code> でトークン更新 → 新しいアクセストークンをメモリに保存 → 元のリクエストを自動リトライする</li>

<li><strong>ログアウト</strong><br>サーバー側でリフレッシュトークンをブラックリスト登録 → メモリ上のアクセストークンをクリアする</li>
</ol>
</div></div>



<p class="wp-block-paragraph">「メモリ保存だとページリロードでトークンが消えるのでは？」という疑問は正しくて、リロード後はステップ1の初期化フローが走ります。有効なリフレッシュCookieがあれば自動でアクセストークンが復元されます。</p>



<h2 id="rtoc-4"  class="wp-block-heading">ROTATE_REFRESH_TOKENSが引き起こす並走リフレッシュ問題</h2>



<p class="wp-block-paragraph">Djangoの <code>djangorestframework-simplejwt</code> では <code>ROTATE_REFRESH_TOKENS = True</code> を設定すると、リフレッシュのたびに新しいリフレッシュトークンが発行され、古いトークンがブラックリストに登録されます。セキュリティ上望ましい設定ですが、フロントエンドで問題が起きることがあります。</p>



<p class="wp-block-paragraph">ページ読み込み直後など、複数のAPIリクエストが同時に走るタイミングで、それぞれが並走して <code>refreshToken()</code> を呼び出すケースです。1本目のリフレッシュが成功すると古いリフレッシュトークンがブラックリストに入り、2本目以降は同じトークンで呼び出しているためエラーになります。</p>



<p class="wp-block-paragraph">対策は、進行中のリフレッシュリクエストがあれば新たに呼び出さず、同じPromiseを使い回す「mutex」パターンです。シンプルな実装で解決できます。詳しくはフロントエンド実装の記事で解説します。</p>



<h2 id="rtoc-5"  class="wp-block-heading">バックエンド（Django）の実装</h2>



<p class="wp-block-paragraph">SimpleJWT・Djoserの設定と、RedisキャッシュによるレートリミットミドルウェアをDjangoで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-simplejwt-djoser-setup/">Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</a>
						<span class="p-blogCard__excerpt">DjangoでJWT認証を実装したい SimpleJWTとDjoserをどう組み合わせるか知りたい 不要なエンドポイントを封鎖してセキュリティを高めたい この記事は、Next.js + Django J&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 id="rtoc-6"  class="wp-block-heading">フロントエンド（Next.js）の実装</h2>



<p class="wp-block-paragraph">アクセストークンのメモリ管理・セッションフラグ・refreshToken()のmutex・apiFetch()の自動リトライをTypeScriptで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-jwt-memory-token-auth/">Next.js JWT認証の実装｜アクセストークンをメモリ管理・リフレッシュ並走バグを防ぐmutexパターン</a>
						<span class="p-blogCard__excerpt">Next.jsでJWTトークンをどこに保存すればいいか知りたい 複数リクエストが同時にリフレッシュを呼んでエラーになる問題を解決したい 401レスポンスを受け取ったときに自&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js の rewrite を基礎から応用まで完全解説</title>
		<link>https://cfxlog.com/nextjs-rewrite-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 07 Jan 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Next.js]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4610</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/nextjs-rewrite-guide-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>Next.js を使っていると、next.config.ts に登場する rewrites という設定を目にすることがあります。 こうした断片的な説明はよく見かけますが、次のような内容まで整理されている情報はあまり見かけ [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/nextjs-rewrite-guide-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">Next.js を使っていると、<code>next.config.ts</code> に登場する <code>rewrites</code> という設定を目にすることがあります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>「URL を変えずに API にアクセスできるらしい」</li>



<li>「CORS 対策になる」</li>



<li>「Docker 構成でよく使われる」</li>
</ul>
</div></div>



<p class="wp-block-paragraph">こうした断片的な説明はよく見かけますが、次のような内容まで整理されている情報はあまり見かけません。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>結局 rewrite とは何なのか</strong></li>



<li><strong>どんな時に使うべきか</strong></li>



<li><strong>どんな時に不要なのか</strong></li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事では、Next.js の rewrite を <strong>基礎 → 仕組み → 実務的なメリット → 設計上の注意点 → 削除という判断</strong>まで、順を追って解説します。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="4610" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">Next.js の rewrite を基礎から応用まで完全解説</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-2">Next.js の rewrite の概要</a></li><li class="rtoc-item"><a href="#rtoc-3">rewrite と redirect との違い</a></li><li class="rtoc-item"><a href="#rtoc-4">rewrite の基本的な書き方</a></li><li class="rtoc-item"><a href="#rtoc-5">rewrite が動作する仕組み</a></li><li class="rtoc-item"><a href="#rtoc-6">rewrite を使うメリット</a></li><li class="rtoc-item"><a href="#rtoc-7">応用：環境分岐を含む rewrite 設定</a></li><li class="rtoc-item"><a href="#rtoc-8">「rewrite を使わないという」判断</a></li><li class="rtoc-item"><a href="#rtoc-9">rewrite を使うべきかどうかの判断基準</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-10">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">Next.js の rewrite を基礎から応用まで完全解説</h2>



<h3 id="rtoc-2"  class="wp-block-heading">Next.js の rewrite の概要</h3>



<p class="wp-block-paragraph"><strong>rewrite は、URL を変えずに、サーバー側で別の URL にリクエストを転送する仕組み</strong>です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ブラウザのアドレスバーは変わらない</li>



<li>HTTP ステータスコードも 301 / 302 ではない</li>



<li>クライアントは「同じオリジン」にアクセスしている感覚のまま</li>
</ul>
</div></div>



<p class="wp-block-paragraph">リダイレクトとは違って、クライアントに見せずに裏側で交通整理をして、別の場所にアクセスするとも言い換えられます。</p>



<p class="wp-block-paragraph">つまり、Next.js が <strong>リバースプロキシの役割</strong>を担います。</p>



<h3 id="rtoc-3"  class="wp-block-heading">rewrite と redirect との違い</h3>



<p class="wp-block-paragraph">ここは混同されやすいポイントなので、先に整理します。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>項目</th><th>rewrite</th><th>redirect</th></tr></thead><tbody><tr><td>URL 表示</td><td>変わらない</td><td>変わる</td></tr><tr><td>処理場所</td><td>サーバー内部</td><td>クライアント</td></tr><tr><td>主な用途</td><td>API プロキシ</td><td>URL 正規化・移転</td></tr><tr><td>SEO</td><td>影響なし</td><td>301/302 の意味を持つ</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">rewrite は <strong>「内部転送」</strong>、redirect は<strong>「外部転送」</strong>と覚えると理解しやすいです。</p>



<h3 id="rtoc-4"  class="wp-block-heading">rewrite の基本的な書き方</h3>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">TypeScript</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// next.config.ts
export default {
  async rewrites() {
    return &#91;
      {
        source: '/api/:path*',
        destination: 'http://localhost:8000/api/:path*',
      },
    &#93;;
  },
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #616E88">// next.config.ts</span></span>
<span class="line"><span style="color: #81A1C1">export</span><span style="color: #D8DEE9FF"> </span><span style="color: #81A1C1">default</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">  </span><span style="color: #81A1C1">async</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">rewrites</span><span style="color: #ECEFF4">()</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> &#91;</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #D8DEE9">source</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">/api/:path*</span><span style="color: #ECEFF4">&apos;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #D8DEE9">destination</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">http://localhost:8000/api/:path*</span><span style="color: #ECEFF4">&apos;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #ECEFF4">},</span></span>
<span class="line"><span style="color: #D8DEE9FF">    &#93;</span><span style="color: #81A1C1">;</span></span>
<span class="line"><span style="color: #D8DEE9FF">  </span><span style="color: #ECEFF4">},</span></span>
<span class="line"><span style="color: #ECEFF4">}</span><span style="color: #81A1C1">;</span></span></code></pre></div>



<p class="wp-block-paragraph">この設定により、クライアントから/api/users/にアクセスがあると、実際には以下にリクエストが投げられます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>http://localhost:8000/api/users/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #88C0D0">http://localhost:8000/api/users/</span></span></code></pre></div>



<p class="wp-block-paragraph">つまり、<code>source</code>はクライアントがアクセスするURLであり、<code>destination</code>は「Next.jsサーバー」が内部的に転送する先になります。</p>



<p class="wp-block-paragraph"><code>/:path*</code> は <strong>ワイルドカード</strong>で、後続のパスをそのまま渡します。</p>



<h3 id="rtoc-5"  class="wp-block-heading">rewrite が動作する仕組み</h3>



<p class="wp-block-paragraph">rewrite のリクエストの流れは次のとおりです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>ブラウザが Next.js サーバーにリクエスト</li>



<li>Next.js が <code>rewrites</code> 設定をチェック</li>



<li>条件に一致すれば、内部的に別 URL に転送</li>



<li>レスポンスをクライアントに返却</li>
</ol>
</div></div>



<p class="wp-block-paragraph">クライアントは <strong>「Next.js にアクセスした」</strong>という認識のままです。</p>



<p class="wp-block-paragraph">また、rewrite が同一オリジン扱いになる理由については、 <strong>Next.js サーバーが代理で通信</strong>するため、次の二段構えになるからです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ブラウザ → Next.js</li>



<li>Next.js → バックエンド</li>
</ul>
</div></div>



<p class="wp-block-paragraph">その結果、次のような利点が生まれます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>CORS 設定が不要</li>



<li>Cookie / 認証ヘッダを扱いやすい</li>
</ul>
</div></div>



<h3 id="rtoc-6"  class="wp-block-heading">rewrite を使うメリット</h3>



<p class="wp-block-paragraph">rewriteを使う場合、いくつかメリットがあります。</p>



<h4 class="wp-block-heading">クライアント側の実装がシンプルになる</h4>



<p class="wp-block-paragraph">次のように、相対パスでAPIを呼べるのは大きなメリットです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">TypeScript</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>fetch('/api/agencies/');</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #88C0D0">fetch</span><span style="color: #D8DEE9FF">(</span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">/api/agencies/</span><span style="color: #ECEFF4">&apos;</span><span style="color: #D8DEE9FF">)</span><span style="color: #81A1C1">;</span></span></code></pre></div>



<p class="wp-block-paragraph">これにより、環境ごとのURL切り替えが不要になり、.envを意識しないでよくなります。</p>



<h4 class="wp-block-heading">Docker 構成との相性が良い</h4>



<p class="wp-block-paragraph">Next.js とバックエンドが Docker 内で動いている場合、次のような内部ネットワーク名はブラウザから見られません。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>http://backend:8000/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #88C0D0">http://backend:8000/</span></span></code></pre></div>



<p class="wp-block-paragraph">rewrite を使えば、ブラウザはNext.jsにだけアクセスをし、Next.jsが内部ネットワーク経由で接続するという構図が成り立ちます。</p>



<h4 class="wp-block-heading">CORS を考えなくて済む</h4>



<p class="wp-block-paragraph">rewrite は <strong>同一オリジン扱い</strong>になるので、次のようなCORSを考えなくて済みます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django / FastAPI 側の CORS 設定</li>



<li>本番・開発の切り替え</li>
</ul>
</div></div>



<h3 id="rtoc-7"  class="wp-block-heading">応用：環境分岐を含む rewrite 設定</h3>



<p class="wp-block-paragraph">実務では、以下のような構成がよく見られます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">TypeScript</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>async rewrites() {
  const isProduction =
    process.env.NEXT_PUBLIC_APP_ENV === 'production';

  const apiUrl = isProduction
    ? 'http://backend_kanteiman:8030/'
    : 'http://localhost:8000/';

  return &#91;
    {
      source: '/api/:path*',
      destination: `${apiUrl}/api/:path*`,
      basePath: false,
    },
    {
      source: '/__auth_api__/:path*',
      destination: `${apiUrl}/auth/:path*`,
      basePath: false,
    },
  &#93;;
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9">async</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">rewrites</span><span style="color: #D8DEE9FF">() </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">  </span><span style="color: #81A1C1">const</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">isProduction</span><span style="color: #D8DEE9FF"> </span><span style="color: #81A1C1">=</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #D8DEE9">process</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9">env</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9">NEXT_PUBLIC_APP_ENV</span><span style="color: #D8DEE9FF"> </span><span style="color: #81A1C1">===</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">production</span><span style="color: #ECEFF4">&apos;</span><span style="color: #81A1C1">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">  </span><span style="color: #81A1C1">const</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">apiUrl</span><span style="color: #D8DEE9FF"> </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">isProduction</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">?</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">http://backend_kanteiman:8030/</span><span style="color: #ECEFF4">&apos;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">http://localhost:8000/</span><span style="color: #ECEFF4">&apos;</span><span style="color: #81A1C1">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">  </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> &#91;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #D8DEE9">source</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">/api/:path*</span><span style="color: #ECEFF4">&apos;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #D8DEE9">destination</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">`${</span><span style="color: #D8DEE9">apiUrl</span><span style="color: #ECEFF4">}</span><span style="color: #A3BE8C">/api/:path*</span><span style="color: #ECEFF4">`</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #D8DEE9">basePath</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #81A1C1">false</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">},</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #D8DEE9">source</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&apos;</span><span style="color: #A3BE8C">/__auth_api__/:path*</span><span style="color: #ECEFF4">&apos;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #D8DEE9">destination</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">`${</span><span style="color: #D8DEE9">apiUrl</span><span style="color: #ECEFF4">}</span><span style="color: #A3BE8C">/auth/:path*</span><span style="color: #ECEFF4">`</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">      </span><span style="color: #D8DEE9">basePath</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> </span><span style="color: #81A1C1">false</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">},</span></span>
<span class="line"><span style="color: #D8DEE9FF">  &#93;</span><span style="color: #81A1C1">;</span></span>
<span class="line"><span style="color: #ECEFF4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">この設計でできることは、次のとおりです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li>クライアントは <code>/api/...</code> や <code>/__auth_api__/...</code> にアクセス</li>



<li>Next.js が環境に応じてバックエンドを切り替え</li>



<li>本番では Docker 内部ネットワークを使用</li>
</ul>
</div></div>



<p class="wp-block-paragraph"><strong>設計としては筋が通っています。</strong></p>



<h3 id="rtoc-8"  class="wp-block-heading">「rewrite を使わないという」判断</h3>



<p class="wp-block-paragraph">rewrite はあくまで <strong>選択肢の一つ</strong>です。</p>



<p class="wp-block-paragraph">以下のような構成では、rewrite は不要になります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>API のベース URL を <code>getApiBaseUrl()</code> で一元管理</li>



<li>クライアントが直接 DRF / FastAPI に接続</li>



<li>認証 API も同じ方式で統一</li>
</ul>
</div></div>



<p class="wp-block-paragraph">実際に、次のようなことが起きがちです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>通常 API と Auth API で取得方法が違う</li>



<li><code>NEXT_PUBLIC_API_URL</code> 未設定時だけ rewrite を使う、などの非現実的な分岐</li>



<li>設定を読まないと通信経路が分からない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">つまり、「動くけど、理解しづらい構成」になりがちという問題点もあります。</p>



<p class="wp-block-paragraph">そのため、次のような設計も健全といえます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>rewrite を削除</li>



<li>API 呼び出しをすべて <code>getApiBaseUrl()</code> に統一</li>



<li>Next.js はフロントエンドに集中</li>
</ul>
</div></div>



<h3 id="rtoc-9"  class="wp-block-heading">rewrite を使うべきかどうかの判断基準</h3>



<p class="wp-block-paragraph">rewrite が向いているケースは、例えば次のとおり。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>フロントとバックエンドが密結合</li>



<li>CORS を極力避けたい</li>



<li>Docker 内部ネットワークを隠したい</li>



<li>BFF（Backend for Frontend）構成</li>
</ul>
</div></div>



<p class="wp-block-paragraph">逆に、次のような場合にはrewriteを使わないほうが良いです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>API URL を明示的に管理している</li>



<li>SSR / RSC でサーバー側 fetch が中心</li>



<li>設定の単純さを重視したい</li>



<li>通信経路を明確にしたい</li>
</ul>
</div></div>



<h2 id="rtoc-10"  class="wp-block-heading">まとめ</h2>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>rewrite は <strong>Next.js のプロキシ機能</strong></li>



<li>URL を変えずに内部転送できる強力な仕組み</li>



<li>CORS 回避や Docker 構成で特に有効</li>



<li>しかし <strong>使わない判断も正解</strong></li>



<li>実際に使われていない rewrite は、削除して統一した方が良い</li>
</ul>
</div></div>



<p class="wp-block-paragraph">rewrite は「入れること」よりも、<strong>「なぜ入れるのか」「なぜ外すのか」を説明できること</strong>が重要です。</p>



<p class="wp-block-paragraph">設計をシンプルにするために rewrite を削除するというのも、<strong>正しい Next.js の使い方</strong>といえます。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js × DockerでGoogle認証を導入する時の「環境変数」ベストプラクティス</title>
		<link>https://cfxlog.com/nextjs-docker-google-auth-env/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 30 Nov 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[Next.js]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4877</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/nextjs-docker-google-auth-env.jpg" class="webfeedsFeaturedVisual" /></p>Next.jsでGoogle認証（OAuth）を導入し、Dockerで本番運用するときにハマるポイントです。 環境変数の渡し方が問題だった場合の対策をお伝えします。 目次 Next.js&#160;× DockerでGo [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/nextjs-docker-google-auth-env.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code> がうまく渡らない</li>



<li><code>client_id</code> が空で Google ログインができない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Next.jsでGoogle認証（OAuth）を導入し、Dockerで本番運用するときにハマるポイントです。</p>



<p class="wp-block-paragraph"><strong>環境変数の渡し方</strong>が問題だった場合の対策をお伝えします。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="4877" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">Next.js&nbsp;× DockerでGoogle認証を導入する時の「環境変数」ベストプラクティス</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-2">Next.jsの環境変数の基本</a></li><li class="rtoc-item"><a href="#rtoc-3">Docker運用での落とし穴</a></li><li class="rtoc-item"><a href="#rtoc-4">正しい設定方法（build.args を使う）</a></li><li class="rtoc-item"><a href="#rtoc-5">最後にコンテナの再ビルド・再起動をする</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-6">よくある質問（FAQ）</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-7">Q. <code>environment</code> は設定不要？</a></li><li class="rtoc-item"><a href="#rtoc-8">Q. <code>.env.local</code> は本番で使える？</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-9">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">Next.js&nbsp;× DockerでGoogle認証を導入する時の「環境変数」ベストプラクティス</h2>



<h3 id="rtoc-2"  class="wp-block-heading">Next.jsの環境変数の基本</h3>



<p class="wp-block-paragraph">Next.jsの環境変数には2種類あります。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>環境変数名の形式</th><th>使用場所</th><th>読み取りタイミング</th></tr></thead><tbody><tr><td><code>NEXT_PUBLIC_</code> から始まる</td><td>クライアントサイド（ブラウザ）</td><td><strong>ビルド時</strong></td></tr><tr><td>通常の環境変数</td><td>サーバーサイド（API/SSR）</td><td><strong>実行時</strong></td></tr></tbody></table></figure>



<p class="wp-block-paragraph">NEXT_PUBLIC_ 付きの環境変数は 「ビルド時」 に読み込まれ、JSに静的に埋め込まれます。</p>



<p class="is-style-icon_info wp-block-paragraph">ビルド時に<code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code>が空だと、アプリ中の<code>client_id</code>は空のままになります。実行時に渡しても意味がありません。</p>



<h3 id="rtoc-3"  class="wp-block-heading">Docker運用での落とし穴</h3>



<p class="wp-block-paragraph">よくある間違った設定は、以下の通り。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># ビルド時には使えない
services:
  frontend:
    environment:
      - NEXT_PUBLIC_GOOGLE_CLIENT_ID=xxxxxx.apps.googleusercontent.com</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># ビルド時には使えない</span></span>
<span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">frontend</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">environment</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">NEXT_PUBLIC_GOOGLE_CLIENT_ID=xxxxxx.apps.googleusercontent.com</span></span></code></pre></div>



<p class="wp-block-paragraph">Dockerでは、<code>environment</code> で渡しても <strong>実行時</strong> にしか使えません。</p>



<p class="wp-block-paragraph">そのため、<strong>クライアントサイド用の環境変数には反映されずビルド時に反映されないのです。</strong></p>



<h3 id="rtoc-4"  class="wp-block-heading">正しい設定方法（build.args を使う）</h3>



<p class="wp-block-paragraph">結論、build.argsを使ってビルド時に環境変数を渡します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>services:
  frontend:
    build:
      context: ./frontend
      args:
        NEXT_PUBLIC_API_URL: https://api.example.com/api
        NEXT_PUBLIC_GOOGLE_CLIENT_ID: xxxxxxxx.apps.googleusercontent.com</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">frontend</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">build</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">context</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">./frontend</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">args</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">NEXT_PUBLIC_API_URL</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">https://api.example.com/api</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">NEXT_PUBLIC_GOOGLE_CLIENT_ID</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">xxxxxxxx.apps.googleusercontent.com</span></span></code></pre></div>



<p class="wp-block-paragraph">上記のようにdocker-compose.yamlを書いた場合には、<code>Dockerfile</code>に以下のようにします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Dockerfile</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># クライアント用の環境変数をビルド時に受け取る
ARG NEXT_PUBLIC_API_URL
ENV NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}

ARG NEXT_PUBLIC_GOOGLE_CLIENT_ID
ENV NEXT_PUBLIC_GOOGLE_CLIENT_ID=${NEXT_PUBLIC_GOOGLE_CLIENT_ID}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># クライアント用の環境変数をビルド時に受け取る</span></span>
<span class="line"><span style="color: #569CD6">ARG</span><span style="color: #D4D4D4"> NEXT_PUBLIC_API_URL</span></span>
<span class="line"><span style="color: #569CD6">ENV</span><span style="color: #D4D4D4"> NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">ARG</span><span style="color: #D4D4D4"> NEXT_PUBLIC_GOOGLE_CLIENT_ID</span></span>
<span class="line"><span style="color: #569CD6">ENV</span><span style="color: #D4D4D4"> NEXT_PUBLIC_GOOGLE_CLIENT_ID=${NEXT_PUBLIC_GOOGLE_CLIENT_ID}</span></span></code></pre></div>



<p class="is-style-icon_good wp-block-paragraph">これで Next.js のビルド時に <code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code> が正しく埋め込まれます！</p>



<h3 id="rtoc-5"  class="wp-block-heading">最後にコンテナの再ビルド・再起動をする</h3>



<p class="wp-block-paragraph">環境変数を修正したら、<strong>必ず再ビルド</strong>してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker-compose down
docker-compose build --no-cache
docker-compose up -d</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker-compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">down</span></span>
<span class="line"><span style="color: #DCDCAA">docker-compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">build</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-cache</span></span>
<span class="line"><span style="color: #DCDCAA">docker-compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">値が空のままビルドされると、再起動しても直りません。<br>再ビルドが必須です！</p>



<h2 id="rtoc-6"  class="wp-block-heading">よくある質問（FAQ）</h2>



<h3 id="rtoc-7"  class="wp-block-heading">Q. <code>environment</code> は設定不要？</h3>



<p class="wp-block-paragraph"><code>NEXT_PUBLIC_</code> 環境変数は、基本的に<code>build.args</code>のみで大丈夫です。</p>



<p class="wp-block-paragraph">一方で、APIやSSRなどのサーバーサイドで参照する変数の場合にはenvironmentへの登録が必要です。</p>



<h3 id="rtoc-8"  class="wp-block-heading">Q. <code>.env.local</code> は本番で使える？</h3>



<p class="wp-block-paragraph">Docker本番では反映されないので、使えません。</p>



<p class="wp-block-paragraph"><code>.env.local</code>はその名の通り、ローカル開発用の環境変数設定ファイルです。</p>



<h2 id="rtoc-9"  class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">本記事の結論をまとめます。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>やること</th><th>方法</th></tr></thead><tbody><tr><td>公開環境変数を渡す</td><td><code>build.args</code> + <code>Dockerfile ARG/ENV</code></td></tr><tr><td>サーバー環境変数を渡す</td><td><code>environment</code></td></tr><tr><td>変更後の対応</td><td><code>docker-compose build --no-cache</code></td></tr><tr><td>.env.local</td><td>本番では使わない</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Next.js × Docker で Google OAuth を使うときは、以下を気をつけましょう。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code> は <strong>ビルド時に渡す！</strong></li>



<li>Docker では <code>build.args</code> で渡し、Dockerfile に <code>ARG</code>/<code>ENV</code> を必ず書く！</li>



<li>再ビルドは <strong>忘れずに！</strong></li>
</ul>
</div></div>



<p class="wp-block-paragraph">これはGoogle認証だけでなく、<strong>すべての <code>NEXT_PUBLIC_</code> 環境変数に共通</strong>です。</p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
