<?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>トラブルシューティング &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/tag/troubleshooting/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Wed, 18 Nov 2026 22:05:27 +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>トラブルシューティング &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>dig +shortで何も表示されない原因｜空出力とDNSエラーを見分ける方法</title>
		<link>https://cfxlog.com/dig-short-empty/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 15 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[Linux]]></category>
		<category><![CDATA[CLIツール]]></category>
		<category><![CDATA[DNS]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5786</guid>

					<description><![CDATA[dig +shortが空になるときの確認手順を解説。NXDOMAIN、NODATA、SERVFAIL、通信失敗を通常出力で切り分けます。]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">dig example.com +short を実行したのに、何も表示されない。</p>



<p class="wp-block-paragraph">「ドメインが存在しないのかな？」と思いがちですが、空出力だけではそこまで判断できません。</p>



<p class="wp-block-paragraph">+short は結果を短く見るための指定。調査に必要な status なども省略されます。今回は、空になったときにどこを確認すればよいかをご紹介します。</p>



<h2 class="wp-block-heading">最初に+shortを外す</h2>



<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="コピー" 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>dig example.com. A +short
dig example.com. A</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig example.com. A +short</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig example.com. A</span></span></code></pre></div>



<p class="wp-block-paragraph">同じ名前・同じタイプで比較してください。最初は A、次は AAAA のように条件を変えると、原因が分かりにくくなります。</p>



<p class="wp-block-paragraph">通常出力に戻したら、status、ANSWER、AUTHORITY、SERVER を順番に見ます。</p>


<h2 class="wp-block-heading">+shortが空になる主な原因</h2>
<h3 class="wp-block-heading">原因① 名前が存在しない</h3>



<p class="wp-block-paragraph">status が NXDOMAIN なら、問い合わせた名前が存在しないという回答です。</p>



<p class="wp-block-paragraph">ドメイン全体が未登録の場合だけでなく、www や api などのサブドメインを作っていない場合にも起こります。綴り、登録したゾーン、ホスト名の入力内容を確認してください。</p>



<p class="wp-block-paragraph">レコードを作った直後なら、作成前の NXDOMAIN がキャッシュされている可能性もあります。</p>



<h3 class="wp-block-heading">原因② 指定した種類のレコードがない</h3>



<p class="wp-block-paragraph">NOERROR でも、欲しい種類のレコードがない場合は +short が空になることがあります。</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="コピー" 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>dig example.com. A
dig example.com. AAAA</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig example.com. A</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig example.com. AAAA</span></span></code></pre></div>



<p class="wp-block-paragraph">IPv4 の A だけ公開し、IPv6 の AAAA を公開していない構成なら、AAAA が空でも不自然ではありません。</p>



<p class="wp-block-paragraph">このような NODATA は status 名ではなく応答の状態です。NOERROR と回答件数だけで決めず、SOA や委任情報など応答全体を確認します。</p>



<h3 class="wp-block-heading">原因③ SERVFAILやREFUSEDが省略されている</h3>



<p class="wp-block-paragraph">回答を作れない SERVFAIL、問い合わせを拒否する REFUSED でも、+short では判断に必要な情報が見えなくなることがあります。</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="コピー" 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>dig @8.8.8.8 example.com. A
dig @1.1.1.1 example.com. A</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @1.1.1.1 example.com. A</span></span></code></pre></div>



<p class="wp-block-paragraph">リゾルバーを指定して比べ、名前全体の問題か、問い合わせ先や経路による問題かを調べます。</p>



<p class="wp-block-paragraph">SERVFAIL の場合は、権威 DNS への到達性、委任、DNSSEC などを確認します。いきなりレコードを削除して作り直す前に、どの応答になっているかを残しておくと安心です。</p>



<h3 class="wp-block-heading">原因④ 通信失敗やスクリプトで出力を捨てている</h3>



<p class="wp-block-paragraph">timeout の診断文が出る場合もあり、通信失敗が必ず無言になるわけではありません。スクリプトで出力を捨てていないかも確認します。</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="コピー" 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>dig @8.8.8.8 example.com. A +time=3 +tries=1
dig @8.8.8.8 example.com. A +tcp +time=3 +tries=1</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A +time=3 +tries=1</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A +tcp +time=3 +tries=1</span></span></code></pre></div>



<p class="wp-block-paragraph">通常の名前解決はできるのに外部 DNS 指定だけ失敗する場合は、ネットワーク側で外部の DNS 通信が制限されている可能性があります。</p>


<h2 class="wp-block-heading">空出力を誤解しないための注意点</h2>
<h3 class="wp-block-heading">+shortはIPアドレス専用の出力ではない</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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>dig www.example.com. A +short</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig www.example.com. A +short</span></span></code></pre></div>



<p class="wp-block-paragraph">CNAME を使う名前では、別名のホスト名と IP アドレスが続けて出る場合があります。「最初の1行は必ず IP」という前提で処理しないでください。</p>



<p class="wp-block-paragraph">回答の種類と TTL を簡潔に見たいなら、次の指定も便利です。</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="コピー" 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>dig www.example.com. A +noall +answer</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig www.example.com. A +noall +answer</span></span></code></pre></div>



<p class="wp-block-paragraph">ただし、この指定も status を省略します。障害調査の最初は通常出力に戻すのが確実です。</p>



<h3 class="wp-block-heading">監視では空かどうかだけで判定しない</h3>



<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>DNS 応答を受け取れたか</li>



<li>status が想定どおりか</li>



<li>期待する種類のレコードがあるか</li>



<li>回答が期待する値や範囲に収まっているか</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このように分けて確認します。dig の終了コードが0でも、NXDOMAIN の応答を受け取っている場合がある点にも注意してください。</p>



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



<p class="wp-block-paragraph">+short は答えだけを素早く見るには便利ですが、空になった理由までは分かりません。困ったらいったん外す。これだけでも、次に調べる場所をかなり絞れます。</p>



<p class="wp-block-paragraph">基本構文や出力の全体像は、<a href="https://cfxlog.com/linux-dig-command/">digコマンドの使い方をまとめた総合ガイド</a>でも解説しています。</p>



<h2 class="wp-block-heading">参考資料</h2>


<ul><li><a href="https://bind9.readthedocs.io/en/stable/manpages.html#dig-dns-lookup-utility">ISC BIND 9：dig</a></li><li><a href="https://developers.google.com/speed/public-dns/docs/troubleshooting">Google Public DNS：Troubleshooting</a></li></ul>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>dig +traceの見方｜DNSの委任と名前解決が止まる場所を調べる方法</title>
		<link>https://cfxlog.com/dig-trace/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 11 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[Linux]]></category>
		<category><![CDATA[CLIツール]]></category>
		<category><![CDATA[DNS]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5783</guid>

					<description><![CDATA[dig +traceのルート・TLD・権威DNSの読み方を解説。途中で止まる場合の確認事項と通常の問い合わせとの違いを紹介します。]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">dig +trace を実行すると、NS レコードがたくさん表示されます。</p>



<p class="wp-block-paragraph">便利そうだけど、どこを見ればいいのか分からない。そんな方もいらっしゃるかと思います。</p>



<p class="wp-block-paragraph">+trace は、ルートから委任をたどる流れを確認したいときに便利です。今回は、出力をまとまりごとに読む方法をご紹介します。</p>



<h2 class="wp-block-heading">まずは基本のコマンド</h2>



<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="コピー" 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>dig example.com. A +trace</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig example.com. A +trace</span></span></code></pre></div>



<p class="wp-block-paragraph">通常の dig では設定済みのリゾルバーへ問い合わせます。+trace では、dig がルートから順に DNS サーバーへ問い合わせ、委任をたどります。</p>



<p class="wp-block-paragraph">つまり、手元の端末から複数の DNS サーバーへの通信が必要です。社内などで外部の53番ポートが制限されていると、通常の名前解決はできても +trace は失敗することがあります。</p>



<h2 class="wp-block-heading">出力はルート・TLD・権威DNSに分けて読む</h2>



<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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>.             IN NS  &#91;ルートDNSの名前&#93;
com.          IN NS  &#91;comのDNSの名前&#93;
example.com.  IN NS  &#91;対象ゾーンの権威DNSの名前&#93;
example.com.  IN A   &#91;問い合わせた名前のIPv4アドレス&#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="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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">.             IN NS  [ルートDNSの名前]</span></span>
<span class="line"><span style="color: #D8DEE9FF">com.          IN NS  [comのDNSの名前]</span></span>
<span class="line"><span style="color: #D8DEE9FF">example.com.  IN NS  [対象ゾーンの権威DNSの名前]</span></span>
<span class="line"><span style="color: #D8DEE9FF">example.com.  IN A   [問い合わせた名前のIPv4アドレス]</span></span></code></pre></div>



<p class="wp-block-paragraph">最後だけを見るのではなく、どのゾーンから次のサーバーを案内されているかを追います。</p>



<h3 class="wp-block-heading">ルートからTLDへ</h3>



<p class="wp-block-paragraph">ルートは、com や jp などの TLD を管理する DNS サーバーを案内します。ここでは、対象ドメインの A レコードが返らなくても正常です。</p>



<h3 class="wp-block-heading">TLDから対象ゾーンへ</h3>



<p class="wp-block-paragraph">次に、TLD 側から対象ドメインの権威 DNS を案内されます。ネームサーバー変更後の調査では、この親側の委任が想定どおりかを確認します。</p>



<p class="wp-block-paragraph">DNS 管理画面に NS を追加する操作と、レジストラで委任先を変更する操作は別になる場合があります。子側に NS を書いただけで親側の委任が変わるとは限りません。</p>



<h3 class="wp-block-heading">権威DNSから回答へ</h3>



<p class="wp-block-paragraph">対象ゾーンの権威 DNS までたどり着くと、A などの回答、CNAME、あるいは存在しない旨の応答を受け取ります。CNAME が返った場合は、参照先の名前解決も別に確認してください。</p>



<p class="wp-block-paragraph">各まとまりの末尾にある Received &#8230; from &#8230; は、その応答を受け取った相手を確認する手掛かりになります。</p>



<h2 class="wp-block-heading">途中で止まる場合は到達先と委任を確認する</h2>



<p class="wp-block-paragraph">TLD 側から NS を案内された後に止まるなら、次の項目を確認します。</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>案内された権威 DNS へ手元から通信できるか</li>



<li>そのサーバーが対象ゾーンを管理しているか</li>



<li>DNS 事業者側のゾーンが有効になっているか</li>



<li>必要な glue レコードに不整合がないか</li>
</ul>
</div></div>



<p class="wp-block-paragraph">例えば example.com の NS が ns1.example.com のようにゾーン内の名前なら、依存関係を解くため親側の glue が必要になる場合があります。登録方法はレジストラによって異なります。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">+trace が止まった場所だけで、相手の DNS サーバーの障害とは断定できません。手元のネットワーク制限も確認してください。</p>



<h2 class="wp-block-heading">権威DNSごとの回答を比較する</h2>



<p class="wp-block-paragraph">trace でたどり着いたサーバーが1台正常でも、他のサーバーが正常とは限りません。案内された各 NS に直接問い合わせて確認します。</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="コピー" 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># ns1.example.net は実際の権威DNSへ置き換える
dig @ns1.example.net example.com. SOA +norecurse
dig @ns1.example.net example.com. A +norecurse</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF"># ns1.example.net は実際の権威DNSへ置き換える</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @ns1.example.net example.com. SOA +norecurse</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @ns1.example.net example.com. A +norecurse</span></span></code></pre></div>



<p class="wp-block-paragraph">aa フラグ、status、回答値を比較してください。同一ゾーンの SOA serial の違いは同期状態を調べる手掛かりになりますが、serial が同じだから内容も必ず同じとは言い切れません。</p>


<h2 class="wp-block-heading">traceの結果を読むときの注意点</h2>
<h3 class="wp-block-heading">@8.8.8.8を付けても全段階をGoogleへ頼むわけではない</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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>dig @8.8.8.8 example.com. A +trace</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A +trace</span></span></code></pre></div>



<p class="wp-block-paragraph">この指定が使われるのは、最初にルート DNS の情報を取得する問い合わせです。その後の委任追跡まで、すべて8.8.8.8経由になるわけではありません。</p>



<p class="wp-block-paragraph">Google Public DNS 自体の名前解決結果を知りたいなら、+trace を外して問い合わせます。</p>



<h3 class="wp-block-heading">DNSSECの完全な検証結果ではない</h3>



<p class="wp-block-paragraph">+trace の出力に DS や RRSIG があっても、それだけで署名検証に成功したとは判断できません。委任経路の確認と DNSSEC 検証は分けて考えてください。</p>



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



<p class="wp-block-paragraph">+trace は、DNS の委任を順番に追いたいときに便利です。親がどの NS を案内しているか、その NS が正しく回答するか、という順に見ると出力を読みやすくなります。</p>



<p class="wp-block-paragraph">基本構文や出力の全体像は、<a href="https://cfxlog.com/linux-dig-command/">digコマンドの使い方をまとめた総合ガイド</a>でも解説しています。</p>



<h2 class="wp-block-heading">参考資料</h2>


<ul><li><a href="https://bind9.readthedocs.io/en/stable/manpages.html#dig-dns-lookup-utility">ISC BIND 9：dig</a></li><li><a href="https://developers.google.com/speed/public-dns/docs/troubleshooting">Google Public DNS：Troubleshooting</a></li></ul>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>DNSが反映されないときの確認方法｜digで権威DNSとキャッシュを比較</title>
		<link>https://cfxlog.com/dig-dns-propagation/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 10 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[Linux]]></category>
		<category><![CDATA[CLIツール]]></category>
		<category><![CDATA[DNS]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5782</guid>

					<description><![CDATA[DNS変更後も古いIPが返る原因を解説。権威DNS、公開リゾルバー、TTL、ネガティブキャッシュを順番に確認します。]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">DNS の A レコードを変更したのに、まだ古いサーバーが表示される。</p>



<p class="wp-block-paragraph">「反映待ちかな？」と思う場面ですが、単に待てばよいケースばかりではありません。</p>



<p class="wp-block-paragraph">登録先が違う、権威 DNS ごとに設定が揃っていない、AAAA だけ古い、といった可能性もあります。今回は dig を使って、どこに古い情報が残っているかを確認していきます。</p>



<h2 class="wp-block-heading">確認する順番は権威DNS→キャッシュDNS</h2>



<p class="wp-block-paragraph">権威 DNS は、そのゾーンの情報を回答するサーバー。キャッシュ DNS は、問い合わせの結果を一定時間保持して利用するサーバーです。</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>権威 DNS が新しい値を返すか確認する</li>



<li>複数のキャッシュ DNS と比較する</li>



<li>DNS が正しければブラウザーや Web サーバー側を調べる</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この順番なら、設定の問題とキャッシュの問題を分けやすくなります。</p>


<h2 class="wp-block-heading">権威DNSで現在の設定を確認する</h2>
<h3 class="wp-block-heading">対象ゾーンの権威DNSを確認する</h3>



<p class="wp-block-paragraph">まずは対象ドメインの NS を取得します。</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="コピー" 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>dig example.com. NS</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig example.com. NS</span></span></code></pre></div>



<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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>dig example.com. NS +trace</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig example.com. NS +trace</span></span></code></pre></div>



<p class="wp-block-paragraph">サブドメインが別ゾーンとして委任されている場合は、そのサブドメインを管理する権威 DNS を調べてください。</p>



<h3 class="wp-block-heading">権威DNSへ直接問い合わせる</h3>



<p class="wp-block-paragraph">以下の ns1.example.net は、調べた権威 DNS の名前に置き換えます。</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="コピー" 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>dig @ns1.example.net www.example.com. A +norecurse
dig @ns1.example.net www.example.com. AAAA +norecurse</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @ns1.example.net www.example.com. A +norecurse</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @ns1.example.net www.example.com. AAAA +norecurse</span></span></code></pre></div>



<p class="wp-block-paragraph">flags に aa があるかも確認します。権威サーバーへ直接問い合わせたのに期待する値がない場合は、設定するゾーン・レコード名・対象サーバーを見直す段階です。</p>



<p class="wp-block-paragraph">NS が複数あるなら、すべて確認します。1台だけ古いと、利用者によって新旧の結果が混ざることがあります。</p>


<h2 class="wp-block-heading">キャッシュDNSと比較する</h2>
<h3 class="wp-block-heading">8.8.8.8と1.1.1.1の結果を比較する</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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>dig @8.8.8.8 www.example.com. A
dig @1.1.1.1 www.example.com. A
dig www.example.com. A</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 www.example.com. A</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @1.1.1.1 www.example.com. A</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig www.example.com. A</span></span></code></pre></div>



<p class="wp-block-paragraph">権威 DNS が新しい値で、キャッシュ DNS の一部だけ古いなら、キャッシュの残存が考えられます。</p>



<p class="wp-block-paragraph">ただし、応答が違うだけで「伝播中」とは断定できません。CDN の地域別応答、社内外で回答を分ける構成、複数 IP による負荷分散でも値は変わります。変更前後の値とサービスの仕様を照らし合わせてください。</p>



<h3 class="wp-block-heading">TTLは秒数で読む</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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>www.example.com.  300  IN  A  192.0.2.10</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">www.example.com.  300  IN  A  192.0.2.10</span></span></code></pre></div>



<p class="wp-block-paragraph">300 は TTL で、単位は秒。権威 DNS の応答では設定された TTL、キャッシュ DNS の応答では通常そのキャッシュの残り時間を確認できます。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">変更後に TTL を短くしても、すでに古い TTL で保存されたキャッシュの期限は短くなりません。</p>



<p class="wp-block-paragraph">移転前に TTL を下げる場合は、変更前の TTL が経過する余裕を持って準備します。なお、期限切れの情報を一時的に返す仕組みなどもあるため、TTL だけで全利用者の切替時刻を保証することはできません。</p>



<h3 class="wp-block-heading">新規追加ならネガティブキャッシュも確認</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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>dig @8.8.8.8 new.example.com. A</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 new.example.com. A</span></span></code></pre></div>



<p class="wp-block-paragraph">NXDOMAIN や NODATA の応答では、AUTHORITY の SOA も確認します。ネガティブキャッシュの時間は SOA の TTL と MINIMUM の関係で決まるため、A レコード側の TTL だけ見ても分かりません。</p>



<h2 class="wp-block-heading">DNSが新しいのに古いサイトが出る場合</h2>



<p class="wp-block-paragraph">DNS の回答が変わっているなら、ブラウザーのキャッシュ、OS やアプリの名前解決、プロキシ、CDN、Web サーバー側へ確認を進めます。ブラウザーが独自の暗号化 DNS を利用し、dig と違う問い合わせ先になっている場合もあります。</p>



<p class="wp-block-paragraph">A を直しても AAAA が古ければ、IPv6 接続だけ旧サーバーへ向かう可能性があります。CNAME を使っている場合は、その参照先の A・AAAA も調べてください。</p>



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



<p class="wp-block-paragraph">DNS の変更後は、権威 DNS の回答を先に確認するのがポイントです。権威側が正しいことを確認できてからキャッシュを比較すれば、「待つべきか、設定を直すべきか」を判断しやすくなります。</p>



<p class="wp-block-paragraph">基本構文や出力の全体像は、<a href="https://cfxlog.com/linux-dig-command/">digコマンドの使い方をまとめた総合ガイド</a>でも解説しています。</p>



<h2 class="wp-block-heading">参考資料</h2>


<ul><li><a href="https://bind9.readthedocs.io/en/stable/manpages.html#dig-dns-lookup-utility">ISC BIND 9：dig</a></li><li><a href="https://developers.google.com/speed/public-dns/docs/troubleshooting">Google Public DNS：Troubleshooting</a></li></ul>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>digでNXDOMAIN・SERVFAILが出る原因と対処法｜DNSエラーの切り分け手順</title>
		<link>https://cfxlog.com/dig-nxdomain-servfail/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 09 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[Linux]]></category>
		<category><![CDATA[CLIツール]]></category>
		<category><![CDATA[DNS]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5781</guid>

					<description><![CDATA[digのNXDOMAIN、SERVFAIL、REFUSED、timeoutを症状別に解説。NOERRORなのに回答がない場合やDNSSECの確認手順も紹介します。]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">dig を実行したものの、IP アドレスが返ってこない。</p>



<p class="wp-block-paragraph">そんなときに最初に見たいのが、出力の上にある status です。</p>



<p class="wp-block-paragraph">同じ「名前解決できない」状態でも、名前が存在しない場合と、DNS サーバーが回答を作れない場合では確認する場所が変わります。</p>



<p class="wp-block-paragraph">今回は、dig でよく見るエラーの意味と、次に実行するコマンドを順番にご紹介します。</p>



<h2 class="wp-block-heading">まずは省略せずに結果を見る</h2>



<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="コピー" 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>dig example.com. A</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig example.com. A</span></span></code></pre></div>



<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">Bash</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="コピー" 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>;; ->>HEADER&lt;&lt;- opcode: QUERY, status: NXDOMAIN, id: 12345
;; flags: qr rd ra; QUERY: 1, ANSWER: 0, AUTHORITY: 1, ADDITIONAL: 1</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">;; ->>HEADER&lt;&lt;- opcode: QUERY, status: NXDOMAIN, id: 12345</span></span>
<span class="line"><span style="color: #D8DEE9FF">;; flags: qr rd ra; QUERY: 1, ANSWER: 0, AUTHORITY: 1, ADDITIONAL: 1</span></span></code></pre></div>



<p class="wp-block-paragraph">見る場所は status と ANSWER、AUTHORITY、末尾の SERVER です。SERVER は今回回答した DNS サーバー。まず、どこに問い合わせた結果なのかを押さえておくと調査が楽になります。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">+short だけでは status が見えません。何も出ない場合には、オプションを外して再実行してください。</p>


<h2 class="wp-block-heading">statusとANSWERで原因を切り分ける</h2>
<h3 class="wp-block-heading">NXDOMAINは問い合わせた名前が存在しないという回答</h3>



<p class="wp-block-paragraph">NXDOMAIN は「その名前は存在しない」という DNS の応答です。DNS サーバーから応答自体は返ってきています。</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>DNS 管理画面で、対象のゾーンとレコード名を確認する</li>



<li>別のリゾルバーでも同じ回答になるか確認する</li>
</ul>
</div></div>



<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="コピー" 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>dig @8.8.8.8 www.example.com. A
dig @1.1.1.1 www.example.com. A</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 www.example.com. A</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @1.1.1.1 www.example.com. A</span></span></code></pre></div>



<p class="wp-block-paragraph">登録したばかりなら、以前の「存在しない」という回答がキャッシュされている可能性もあります。一方、権威 DNS にも対象がないなら、待つだけでは解決しません。</p>



<h3 class="wp-block-heading">NOERRORなのにANSWERが0件ならレコードの種類を見る</h3>



<p class="wp-block-paragraph">NOERROR は、欲しい IP アドレスが必ず返ったという意味ではありません。</p>



<p class="wp-block-paragraph">例えば、名前は存在していても AAAA レコードを登録していなければ、AAAA の問い合わせに回答がないことがあります。こうした状態は NODATA と呼ばれますが、status に NODATA と表示されるわけではありません。</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="コピー" 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>dig example.com. A
dig example.com. AAAA
dig example.com. MX</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig example.com. A</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig example.com. AAAA</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig example.com. MX</span></span></code></pre></div>



<p class="wp-block-paragraph">NOERROR・ANSWER 0件だけで NODATA と決めず、AUTHORITY に SOA があるか、委任を示す NS が返っていないかも確認します。問い合わせた DNS とレコードタイプをセットで見てください。</p>



<h3 class="wp-block-heading">SERVFAILはDNSサーバーが回答を作れなかった状態</h3>



<p class="wp-block-paragraph">SERVFAIL には、権威 DNS への到達失敗、委任の不整合、DNSSEC の検証失敗など複数の原因があります。</p>



<p class="wp-block-paragraph">まずは別のリゾルバーで同じ名前・同じタイプを調べます。一部だけ失敗するなら、その経路やキャッシュ、検証の違いを疑います。</p>



<p class="wp-block-paragraph">DNSSEC の影響を調べるときは、同じリゾルバーに対して次の2つを比較します。</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="コピー" 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>dig @8.8.8.8 example.com. A +dnssec
dig @8.8.8.8 example.com. A +dnssec +cdflag</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A +dnssec</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A +dnssec +cdflag</span></span></code></pre></div>



<p class="wp-block-paragraph">+cdflag を付けた場合だけ回答が返るなら、DNSSEC の検証失敗が疑われます。ただし、これだけで原因を確定できるわけではありません。DNS 事業者の診断と合わせて、親側の DS、子側の DNSKEY、署名の状態を確認します。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">+dnssec は DNSSEC 関連情報を要求するオプションです。dig 自身が署名を検証するわけではありません。+cdflag も調査用に使い、恒久的な回避策にはしないでください。</p>



<h3 class="wp-block-heading">REFUSEDとtimeoutは別の状態</h3>



<p class="wp-block-paragraph">REFUSED は問い合わせを拒否したという応答。権威 DNS に再帰問い合わせを頼んでいたり、アクセス制限があったりする場合に確認します。</p>



<p class="wp-block-paragraph">timeout は時間内に応答を受け取れなかった状態で、DNS の応答コードではありません。</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="コピー" 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>dig @8.8.8.8 example.com. A +time=3 +tries=1
dig @8.8.8.8 example.com. A +tcp +time=3 +tries=1</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 nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A +time=3 +tries=1</span></span>
<span class="line"><span style="color: #D8DEE9FF">dig @8.8.8.8 example.com. A +tcp +time=3 +tries=1</span></span></code></pre></div>



<p class="wp-block-paragraph">TCP では通る場合、UDP の通信経路や応答サイズの影響を調べる手掛かりになります。両方失敗する場合も、DNS サーバー停止とは限りません。ネットワーク側で外部 DNS への接続が制限されている可能性があります。</p>



<h2 class="wp-block-heading">終了コードだけで成功と判断しない</h2>



<p class="wp-block-paragraph">dig は NXDOMAIN の応答を受け取った場合でも、終了コードが0になることがあります。シェルでエラーが出なかったことと、目的のレコードが取得できたことは別です。</p>



<p class="wp-block-paragraph">監視やスクリプトでは、通信結果に加えて status と期待する回答の有無を確認してください。</p>



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



<p class="wp-block-paragraph">名前解決で困ったら、まずは +short を外して status を確認します。NXDOMAIN なら名前と登録先、SERVFAIL なら権威 DNS・委任・DNSSEC、timeout なら通信経路へと確認を進めると整理しやすいです。</p>



<p class="wp-block-paragraph">基本構文や出力の全体像は、<a href="https://cfxlog.com/linux-dig-command/">digコマンドの使い方をまとめた総合ガイド</a>でも解説しています。</p>



<h2 class="wp-block-heading">参考資料</h2>


<ul><li><a href="https://bind9.readthedocs.io/en/stable/manpages.html#dig-dns-lookup-utility">ISC BIND 9：dig</a></li><li><a href="https://developers.google.com/speed/public-dns/docs/troubleshooting">Google Public DNS：Troubleshooting</a></li></ul>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Invalid HTTP_HOST headerの原因と直し方｜Django</title>
		<link>https://cfxlog.com/django-invalid-http-host-underscore/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 02 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[サーバー運用]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/django-invalid-http-host-underscore/</guid>

					<description><![CDATA[この 400 は、ホスト名にアンダースコア（_）が入っていると起きます。 Docker Compose のサービス名を backend_myapp のように付けて、その名前で Django につなぐと出やすいエラーです。 [&#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>Django に「Invalid HTTP_HOST header」と出て、400 Bad Request になる</li>



<li>エラーに「not valid according to RFC 1034/1035」と書かれている</li>



<li>ALLOWED_HOSTS に &#8220;*&#8221; を入れても直らない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この 400 は、<strong>ホスト名にアンダースコア（_）が入っている</strong>と起きます。</p>



<p class="wp-block-paragraph">Docker Compose のサービス名を <code>backend_myapp</code> のように付けて、その名前で Django につなぐと出やすいエラーです。</p>



<p class="wp-block-paragraph">僕も VPS にアプリを載せたとき、これで画面が 500・502 になりました。この記事では、そのときの症状と原因、直し方を紹介します。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>内容</th></tr></thead><tbody><tr><td>Django</td><td>6.1.3</td></tr><tr><td>Docker</td><td>Docker Engine 29.9.3・Docker Compose 5.7.0</td></tr><tr><td>OS（VPS）</td><td>Ubuntu 26.04.1 LTS</td></tr><tr><td>構成</td><td>Next.js（フロント）から Django（API）へ、Compose のサービス名でつなぐ</td></tr></tbody></table><figcaption class="wp-element-caption">この記事の環境（2026年11月19日に確認）</figcaption></figure>



<h2 class="wp-block-heading">結論：ホスト名をハイフンにして、接続先と ALLOWED_HOSTS をそろえる</h2>



<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>原因：<code>backend_myapp</code> のような _ 入りのホスト名は、Django がホスト名として認めない</li>



<li>ALLOWED_HOSTS = [&#8220;*&#8221;] にしても、この確認は飛ばせない</li>



<li>直し方：Compose のネットワーク別名（aliases）で <code>backend-myapp</code> を足し、その名前でつなぐ</li>



<li>接続先の URL と ALLOWED_HOSTS も、ハイフンの名前にそろえる</li>
</ul>
</div></div>



<h2 class="wp-block-heading">症状：Next.js の画面は 500、API は 502 に見えた</h2>



<p class="wp-block-paragraph">最初に気づいたのは、Django ではなく Next.js の側でした。</p>



<h3 class="wp-block-heading">アプリを起動したら、トップが 500 になった</h3>



<p class="wp-block-paragraph">VPS で2つのアプリを Compose で起動し、中から HTTP で確かめると、片方のトップページが 500 になりました。</p>



<p class="wp-block-paragraph">もう片方のアプリでは、もう1つのアプリの API を呼ぶ部分が 502 でした。</p>



<p class="wp-block-paragraph">どちらも、Next.js がサーバー側で Django の API を呼んでいる部分です。</p>



<h3 class="wp-block-heading">Django は 400 を返していた</h3>



<p class="wp-block-paragraph">たどっていくと、Next.js から Django へのリクエストが 400 で断られていました。</p>



<p class="wp-block-paragraph">Next.js は API の失敗を受けて、画面を 500、転送している API を 502 にしていた、という流れです。</p>



<p class="is-style-icon_info wp-block-paragraph">フロントのエラーだけ見ていると、原因が Django 側にあると気づきにくいです。500・502 が出たら、裏の API の応答も確かめてください。</p>



<p class="wp-block-paragraph">接続先は、Compose のサービス名をそのまま使った <code>http://backend_myapp:8000/</code> のような URL でした。</p>



<h2 class="wp-block-heading">原因：_ の入ったホスト名は RFC 1034/1035 に合わない</h2>



<p class="wp-block-paragraph">Django は、リクエストの Host ヘッダーがホスト名として正しい形かを確かめます。</p>



<p class="wp-block-paragraph">ホスト名に使えるのは英数字とハイフンで、<strong>アンダースコアは使えません</strong>。これが、エラー文にある RFC 1034/1035 の決まりです。</p>



<h3 class="wp-block-heading">Compose のサービス名がそのままホスト名になる</h3>



<p class="wp-block-paragraph">Compose では、同じネットワークのコンテナにサービス名でつなげます。</p>



<p class="wp-block-paragraph">サービス名を <code>backend_myapp</code> にして <code>http://backend_myapp:8000/</code> へリクエストすると、Host ヘッダーも <code>backend_myapp:8000</code> になります。</p>



<p class="wp-block-paragraph">名前解決はできるので、接続自体は届きます。届いたうえで、Django が Host の形を見て断っています。</p>



<h3 class="wp-block-heading">ALLOWED_HOSTS = [&#8220;*&#8221;] でも通らない</h3>



<p class="wp-block-paragraph">ALLOWED_HOSTS を &#8220;*&#8221;（すべて許可）にすれば通りそうですが、通りません。手元の Mac で、Django 6.1.3 を使って確かめました。</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">Python</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>import django
from django.conf import settings
settings.configure(ALLOWED_HOSTS=&#91;"*"&#93;, DEBUG=False)
django.setup()
from django.test import RequestFactory
from django.core.exceptions import DisallowedHost

print("Django", django.get_version())
rf = RequestFactory()
for host in &#91;"backend_myapp:8000", "backend-myapp:8000", "localhost:8000"&#93;:
    req = rf.get("/", HTTP_HOST=host)
    try:
        print(host, "->", req.get_host())
    except DisallowedHost as e:
        print(host, "-> DisallowedHost:", 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: #D4D4D4">import django</span></span>
<span class="line"><span style="color: #D4D4D4">from django.conf import settings</span></span>
<span class="line"><span style="color: #D4D4D4">settings.configure(ALLOWED_HOSTS=["*"], DEBUG=False)</span></span>
<span class="line"><span style="color: #D4D4D4">django.setup()</span></span>
<span class="line"><span style="color: #D4D4D4">from django.test import RequestFactory</span></span>
<span class="line"><span style="color: #D4D4D4">from django.core.exceptions import DisallowedHost</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">print("Django", django.get_version())</span></span>
<span class="line"><span style="color: #D4D4D4">rf = RequestFactory()</span></span>
<span class="line"><span style="color: #D4D4D4">for host in ["backend_myapp:8000", "backend-myapp:8000", "localhost:8000"]:</span></span>
<span class="line"><span style="color: #D4D4D4">    req = rf.get("/", HTTP_HOST=host)</span></span>
<span class="line"><span style="color: #D4D4D4">    try:</span></span>
<span class="line"><span style="color: #D4D4D4">        print(host, "-&gt;", req.get_host())</span></span>
<span class="line"><span style="color: #D4D4D4">    except DisallowedHost as e:</span></span>
<span class="line"><span style="color: #D4D4D4">        print(host, "-&gt; DisallowedHost:", e)</span></span></code></pre></div>



<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">Plaintext</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>Django 6.1.3
backend_myapp:8000 -> DisallowedHost: Invalid HTTP_HOST header: 'backend_myapp:8000'. The domain name provided is not valid according to RFC 1034/1035.
backend-myapp:8000 -> backend-myapp:8000
localhost:8000 -> localhost: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="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: #D4D4D4">Django 6.1.3</span></span>
<span class="line"><span style="color: #D4D4D4">backend_myapp:8000 -&gt; DisallowedHost: Invalid HTTP_HOST header: 'backend_myapp:8000'. The domain name provided is not valid according to RFC 1034/1035.</span></span>
<span class="line"><span style="color: #D4D4D4">backend-myapp:8000 -&gt; backend-myapp:8000</span></span>
<span class="line"><span style="color: #D4D4D4">localhost:8000 -&gt; localhost:8000</span></span></code></pre></div>



<p class="wp-block-paragraph">ALLOWED_HOSTS がすべて許可でも、<strong>アンダースコアの入った名前だけが DisallowedHost</strong> になりました。ハイフンにすると通ります。</p>



<p class="wp-block-paragraph">Django は、ALLOWED_HOSTS と照らし合わせる前に、ホスト名の形を確かめているためです。DisallowedHost になったリクエストは、400 で返されます。</p>



<h2 class="wp-block-heading">直し方：ネットワーク別名をハイフンにする</h2>



<p class="wp-block-paragraph">サービス名はそのままにして、ハイフンの別名を足すのがいちばん手早い直し方です。</p>



<h3 class="wp-block-heading">aliases でハイフンの名前を足す</h3>



<p class="wp-block-paragraph">compose.yaml で、Django のサービスにネットワークの別名を付けます。</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">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:
  backend_myapp:
    build: ./backend
    networks:
      default:
        aliases:
          - backend-myapp
      proxy:
        aliases:
          - backend-myapp

networks:
  proxy:
    external: true</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: #D4D4D4">services:</span></span>
<span class="line"><span style="color: #D4D4D4">  backend_myapp:</span></span>
<span class="line"><span style="color: #D4D4D4">    build: ./backend</span></span>
<span class="line"><span style="color: #D4D4D4">    networks:</span></span>
<span class="line"><span style="color: #D4D4D4">      default:</span></span>
<span class="line"><span style="color: #D4D4D4">        aliases:</span></span>
<span class="line"><span style="color: #D4D4D4">          - backend-myapp</span></span>
<span class="line"><span style="color: #D4D4D4">      proxy:</span></span>
<span class="line"><span style="color: #D4D4D4">        aliases:</span></span>
<span class="line"><span style="color: #D4D4D4">          - backend-myapp</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">networks:</span></span>
<span class="line"><span style="color: #D4D4D4">  proxy:</span></span>
<span class="line"><span style="color: #D4D4D4">    external: true</span></span></code></pre></div>



<p class="wp-block-paragraph">別のアプリや nginx から、共通のネットワーク（ここでは proxy）経由でつなぐ場合は、そのネットワークにも別名を付けます。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">別名は、ネットワークごとに付けます。つなぐ側と同じネットワークに付いていないと、その名前では見つかりません。</p>



<h3 class="wp-block-heading">接続先の URL と ALLOWED_HOSTS をそろえる</h3>



<p class="wp-block-paragraph">次に、Django を呼ぶ側の接続先を、ハイフンの名前に変えます。</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">Plaintext</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># Next.js 側の .env
BACKEND_URL=http://backend-myapp:8000/

# Django 側の .env
DJANGO_ALLOWED_HOSTS=backend-myapp,app1.example.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"># Next.js 側の .env</span></span>
<span class="line"><span style="color: #D4D4D4">BACKEND_URL=http://backend-myapp:8000/</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Django 側の .env</span></span>
<span class="line"><span style="color: #D4D4D4">DJANGO_ALLOWED_HOSTS=backend-myapp,app1.example.com</span></span></code></pre></div>



<p class="wp-block-paragraph">Django の ALLOWED_HOSTS にも、ハイフンの名前を入れます。&#8221;*&#8221; のままにせず、使う名前だけを並べておくのがおすすめです。</p>



<p class="wp-block-paragraph">僕のときは、2つのアプリのそれぞれで、接続先の URL・.env・ALLOWED_HOSTS を1つずつそろえる必要がありました。</p>



<p class="wp-block-paragraph">1か所だけ直すと、別の画面で同じ 502 が残ります。実際に僕も、片方を直したあと、もう片方のアプリの API でも同じ原因の 502 に気づきました。</p>



<p class="wp-block-paragraph">ALLOWED_HOSTS などの設定を .env から読む書き方は、こちらの記事で紹介しています。</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/03/python-django-settings-best-practices-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/python-django-settings-best-practices/">【Django】settings.pyの僕的ベストプラクティスをご紹介</a>
						<span class="p-blogCard__excerpt">settings.pyのベストプラクティスが知りたい！ 本記事では、僕が個人開発で使っているsettings.pyの内容を公開します。 ぜひ参考にしてみてください。 【Django】settin&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">コンテナを作り直して確かめる</h3>



<p class="wp-block-paragraph">.env や別名を変えたら、コンテナを作り直して反映します。</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">ShellScript</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 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: #D4D4D4">docker compose up -d</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の環境では、これで両方のトップページと、アプリ間の API がすべて 200 になりました。</p>



<h2 class="wp-block-heading">ほかの直し方と気をつけること</h2>



<p class="wp-block-paragraph">別名を足す以外にも、直し方はあります。</p>



<h3 class="wp-block-heading">これから作るなら、サービス名をハイフンにする</h3>



<p class="wp-block-paragraph">新しく compose.yaml を書くなら、最初から <code>backend-myapp</code> のようにハイフンでサービス名を付ければ、この問題は起きません。</p>



<p class="wp-block-paragraph">ただ、すでに動いているサービスの名前を変えると、depends_on や接続先の URL など、その名前を使っている所をすべて直すことになります。</p>



<p class="wp-block-paragraph">動いているものは、別名を足すほうが手早く済みます。</p>



<h3 class="wp-block-heading">nginx から転送するときは Host に気をつける</h3>



<p class="wp-block-paragraph">nginx から Django へ転送するときに <code>proxy_set_header Host $host;</code> を書いていれば、Django に届く Host は公開ドメインになります。</p>



<p class="wp-block-paragraph">この場合はサービス名に _ があっても問題になりません。ALLOWED_HOSTS には公開ドメインを入れます。</p>



<p class="wp-block-paragraph">問題になるのは、Next.js のサーバー側など、<strong>コンテナから Django を直接呼ぶ部分</strong>です。</p>



<p class="wp-block-paragraph">Compose の基本的な書き方は、こちらの記事にまとめています。</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/docker-compose-guide/">Docker Composeの使い方｜compose.yamlの書き方とコマンド</a>
						<span class="p-blogCard__excerpt">docker run のオプションが長くなって、毎回打つのがつらい Web アプリと DB をまとめて起動・停止したい compose.yaml の depends_on や ports の書き方がよく分からな&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">よくある質問</h2>



<div class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-main">
<div class="swell-block-faq__item"><h3 class="faq_q">ALLOWED_HOSTS に &#8220;backend_myapp&#8221; を書いても直りませんか？</h3><div class="faq_a">
<p class="wp-block-paragraph">直りません。Django は ALLOWED_HOSTS を見る前に、ホスト名の形を確かめているためです。</p>



<p class="wp-block-paragraph">名前のほうをハイフンに変えてください。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">ブラウザから見ると正常なのに、一部の画面だけ 500 になります。</h3><div class="faq_a">
<p class="wp-block-paragraph">サーバー側で API を呼んでいる画面だけが失敗している可能性があります。</p>



<p class="wp-block-paragraph">コンテナ同士の接続先の URL に、_ の入った名前がないか確かめてください。</p>
</div></div>
</div>



<h2 class="wp-block-heading">まとめ：_ 入りのホスト名をやめれば 400 は消える</h2>



<p class="wp-block-paragraph">「Invalid HTTP_HOST header … RFC 1034/1035」の 400 は、ホスト名にアンダースコアが入っていると出ます。ALLOWED_HOSTS を &#8220;*&#8221; にしても通りません。</p>



<p class="wp-block-paragraph">Compose ならネットワーク別名でハイフンの名前を足し、接続先の URL と ALLOWED_HOSTS をそろえれば直ります。</p>



<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/python-django-guide/">Django完全入門ガイド｜MTVの基本から認証・API・デプロイまで全ステップ解説</a>
						<span class="p-blogCard__excerpt">Djangoって何から始めればいいの？ MTVの構造がよくわからない 認証やAPI連携、本番デプロイまで一通り学びたい このような疑問にお答えします。 Djangoは、Pythonで書&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">VPS を借りてから、Docker でアプリを公開するまでの流れは、こちらにまとめています。</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/linux-vps-roadmap/">個人でVPSを構築する手順まとめ｜借りてからWebサイト公開・Docker運用まで5ステップ</a>
						<span class="p-blogCard__excerpt">個人で VPS を借りたいけど、何から始めればいいか分からない Web サーバーを立てて、自分のサイトを公開するまでの流れを知りたい HTTPS 化や Docker での運用まで、ど&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>nginxの502 Bad Gateway・504の原因と直し方｜ログで切り分け</title>
		<link>https://cfxlog.com/nginx-502-504-bad-gateway/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 29 Oct 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[nginx]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nginx-502-504-bad-gateway/</guid>

					<description><![CDATA[502 と 504 は、どちらも nginx が裏のアプリ（upstream）から正しい返事を受け取れなかったときに出ます。原因はいくつかありますが、nginx のエラーログに出る1行でほぼ見分けられます。 この記事では [&#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>nginx の裏のアプリにつないだら、502 Bad Gateway や 504 Gateway Timeout が出た</li>



<li>どちらも「アプリがおかしい」のは分かるが、どこから調べればいいか分からない</li>



<li>Gunicorn の timeout や proxy_read_timeout を延ばせばいいのか迷っている</li>
</ul>
</div></div>



<p class="wp-block-paragraph">502 と 504 は、どちらも nginx が裏のアプリ（upstream）から正しい返事を受け取れなかったときに出ます。原因はいくつかありますが、<strong>nginx のエラーログに出る1行</strong>でほぼ見分けられます。</p>



<p class="wp-block-paragraph">この記事では、手元の Docker で nginx と Gunicorn を動かし、502 と 504 をわざと起こしました。エラーログの文言ごとに、原因と直し方をまとめます。</p>



<p class="wp-block-paragraph">試してみると、よく言われることと違う結果もありました。</p>



<p class="wp-block-paragraph"><strong>Gunicorn の timeout を超えた処理は 502 ではなく 500</strong> になり、<strong>アプリを止めたまま nginx を再起動すると、nginx が起動しませんでした</strong>。</p>



<p class="wp-block-paragraph">nginx からアプリへ転送する設定そのものは、こちらの記事で書いています。</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/nginx-reverse-proxy/">nginxリバースプロキシの設定｜proxy_passの末尾スラッシュとHost</a>
						<span class="p-blogCard__excerpt">nginx でアプリへ転送したら、アプリ側で Host やアクセス元の IP がおかしい proxy_pass の最後に / を付けるかどうかで、転送先のパスが変わって混乱している /api/ &#8230;</span>					</div>
				</div>
			</div>
		</div>


<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>内容</th></tr></thead><tbody><tr><td>nginx</td><td>nginx 1.30.6（Docker の nginx:1.30-alpine）</td></tr><tr><td>アプリ</td><td>Gunicorn 23.0.0（python:3.12-alpine、<code>-w 1 --timeout 10</code>）。指定した秒数だけ待ってから返す小さな WSGI アプリ</td></tr><tr><td>わざと切るサーバー</td><td>リクエストを読んだら、返事をせずに接続を切るだけの Python のサーバー</td></tr><tr><td>動かした場所</td><td>Mac の Docker Desktop（docker compose）</td></tr></tbody></table><figcaption class="wp-element-caption">この記事の環境（2026年11月19日に確認）</figcaption></figure>



<h2 class="wp-block-heading">結論：502 は「返事がおかしい」、504 は「待ちきれなかった」</h2>



<p class="wp-block-paragraph">先に、実験の結果をまとめます。</p>



<figure class="wp-block-table"><table><thead><tr><th>状況</th><th>ステータス</th><th>エラーログ（要点）</th></tr></thead><tbody><tr><td>転送先のポートの誤り</td><td>502</td><td><code>connect() failed (111: Connection refused)</code></td></tr><tr><td>アプリが返事をせずに切る</td><td>502</td><td><code>upstream prematurely closed connection</code></td></tr><tr><td>proxy_read_timeout（3秒）を超える処理</td><td>504</td><td><code>upstream timed out (110: ...) while reading response header</code></td></tr><tr><td>Gunicorn の timeout（10秒）を超える処理</td><td>500</td><td>出ない（アプリが返した 500）</td></tr><tr><td>アプリを止めたまま nginx を再起動</td><td>nginx が起動しない</td><td><code>[emerg] host not found in upstream "app"</code></td></tr></tbody></table><figcaption class="wp-element-caption">502・504 の再現結果（nginx 1.30.6、Gunicorn 23.0.0）</figcaption></figure>



<p class="wp-block-paragraph">502 は、nginx がアプリにつなげなかったか、つないだのに正しい返事が返ってこなかったときです。504 は、nginx が決めた時間までに返事が来なかったときです。</p>



<p class="wp-block-paragraph">どちらの場合も、nginx のエラーログに理由が1行で出ます。まずはその1行を見つけるところから始めます。</p>



<h2 class="wp-block-heading">まずエラーログを見る</h2>



<p class="wp-block-paragraph">ブラウザに出る「502 Bad Gateway」の画面には、原因は書かれていません。理由は nginx のエラーログにだけ出ます。</p>



<h3 class="wp-block-heading">エラーログの場所（apt 版と Docker 版）</h3>



<p class="wp-block-paragraph">apt で入れた nginx なら、エラーログは既定で <code>/var/log/nginx/error.log</code> です。</p>



<p class="wp-block-paragraph">Docker の公式イメージの nginx は、ログをファイルではなく標準出力・標準エラーに出すので、<code>docker compose logs</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">ShellScript</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># apt で入れた nginx
sudo tail -n 50 /var/log/nginx/error.log

# Docker の nginx（サービス名が nginx の場合）
docker compose logs --tail 50 nginx</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"># apt で入れた nginx</span></span>
<span class="line"><span style="color: #D4D4D4">sudo tail -n 50 /var/log/nginx/error.log</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Docker の nginx（サービス名が nginx の場合）</span></span>
<span class="line"><span style="color: #D4D4D4">docker compose logs --tail 50 nginx</span></span></code></pre></div>



<p class="is-style-icon_info wp-block-paragraph">apt 版の場所は一般的な既定値です。設定で変えていることもあるので、<code>error_log</code> の行で確かめてください。設定ファイルの場所は、こちらにまとめています。</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/nginx-config-location/">nginxの設定ファイルの場所と書き方｜nginx.conf・conf.d・sites-availableの違い</a>
						<span class="p-blogCard__excerpt">nginx の設定ファイルがどこにあるのか分からない nginx.conf・conf.d・sites-available のどこに書けばいいのか迷う location の書き方と、変更を安全に反映する手順を&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">アクセスログに upstream_status と応答時間を出す</h3>



<p class="wp-block-paragraph">エラーログと合わせて、アクセスログに転送先の情報を出しておくと切り分けが早くなります。実験では次の log_format にしました。</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">Nginx</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>log_format main '"$request" $status upstream=$upstream_addr '
                'upstream_status=$upstream_status '
                'upstream_response_time=$upstream_response_time rt=$request_time';
access_log /dev/stdout main;
error_log /dev/stderr warn;</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: #D4D4D4">log_format main '"$request" $status upstream=$upstream_addr '</span></span>
<span class="line"><span style="color: #D4D4D4">                'upstream_status=$upstream_status '</span></span>
<span class="line"><span style="color: #D4D4D4">                'upstream_response_time=$upstream_response_time rt=$request_time';</span></span>
<span class="line"><span style="color: #D4D4D4">access_log /dev/stdout main;</span></span>
<span class="line"><span style="color: #D4D4D4">error_log /dev/stderr warn;</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>変数</th><th>分かること</th></tr></thead><tbody><tr><td><code>$upstream_addr</code></td><td>実際に転送した宛先（名前を引いたあとの IP とポート）</td></tr><tr><td><code>$upstream_status</code></td><td>アプリが返したステータス。nginx がつなげなかったときは 502・504 になる</td></tr><tr><td><code>$upstream_response_time</code></td><td>アプリを待った秒数</td></tr><tr><td><code>$request_time</code></td><td>リクエスト全体にかかった秒数</td></tr></tbody></table><figcaption class="wp-element-caption">アクセスログに足す変数</figcaption></figure>



<p class="wp-block-paragraph">僕の VPS の nginx も、アクセスログを1行1つの JSON で出していて、<code>$upstream_status</code> と <code>$upstream_response_time</code> を入れています。</p>



<p class="wp-block-paragraph">待った秒数が分かると、504 なら「何秒で切られたか」、502 なら「すぐ断られたのか、しばらく待ってから失敗したのか」が分かります。</p>



<h2 class="wp-block-heading">502 の原因と直し方</h2>



<p class="wp-block-paragraph">502 は、エラーログの文言で原因が分かれます。実験で出た3つと、アプリ側のエラーが 502 に見える場合を順に見ます。</p>



<h3 class="wp-block-heading">原因①：アプリが止まっている・起動している途中</h3>



<p class="wp-block-paragraph">よくあるのは、アプリがまだ動いていないときです。</p>



<p class="wp-block-paragraph">Docker Compose の記事を書いたときも、<code>docker compose restart web</code> の直後に curl で開くと 502 Bad Gateway が返りました。</p>



<p class="wp-block-paragraph">アプリが起動し直している数秒の間に、リクエストが届いたためと考えています。</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/docker-compose-guide/">Docker Composeの使い方｜compose.yamlの書き方とコマンド</a>
						<span class="p-blogCard__excerpt">docker run のオプションが長くなって、毎回打つのがつらい Web アプリと DB をまとめて起動・停止したい compose.yaml の depends_on や ports の書き方がよく分からな&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">今回の実験で <code>docker compose stop app</code> でアプリを止めると、1回目は 60秒待って 504、2回目は 14秒ほどで 502 になりました。502 のときのエラーログは次の行です。</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">Plaintext</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>connect() failed (113: Host is unreachable) while connecting to upstream, client: 172.18.0.1, server: , request: "GET /hello HTTP/1.1", upstream: "http://172.18.0.3:8000/hello", host: "127.0.0.1:18081"</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: #D4D4D4">connect() failed (113: Host is unreachable) while connecting to upstream, client: 172.18.0.1, server: , request: "GET /hello HTTP/1.1", upstream: "http://172.18.0.3:8000/hello", host: "127.0.0.1:18081"</span></span></code></pre></div>



<p class="is-style-big_icon_caution wp-block-paragraph">この秒数とエラー番号は、僕の手元の Mac の Docker Desktop での結果です。Linux の VPS で同じになるとは限りません。止まったアプリへの接続は、502 にも 504 にもなると考えてください。</p>



<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">ShellScript</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 ps
docker compose logs --tail 50 app
docker compose start app</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: #D4D4D4">docker compose ps</span></span>
<span class="line"><span style="color: #D4D4D4">docker compose logs --tail 50 app</span></span>
<span class="line"><span style="color: #D4D4D4">docker compose start app</span></span></code></pre></div>



<p class="wp-block-paragraph">再起動の直後だけ出る 502 なら、起動が終われば消えます。ずっと続くなら、アプリのログに起動時のエラーが出ていないかを見ます。</p>



<h3 class="wp-block-heading">原因②：転送先のポートや名前の誤り</h3>



<p class="wp-block-paragraph">proxy_pass のポートを間違えると、すぐに 502 になります。実験ではアプリが 8000番で待っているところへ、8001番に転送しました。</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">Nginx</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>location /wrongport/ {
    proxy_pass http://app:8001;/
}</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: #D4D4D4">location /wrongport/ {</span></span>
<span class="line"><span style="color: #D4D4D4">    proxy_pass http://app:8001;/</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">返事は 0.001秒ほどで返り、エラーログには次の行が出ました。</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">Plaintext</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>connect() failed (111: Connection refused) while connecting to upstream, client: 172.18.0.1, server: , request: "GET /wrongport/x HTTP/1.1", upstream: "http://172.18.0.3:8001/wrongport/x", host: "127.0.0.1:18081"</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: #D4D4D4">connect() failed (111: Connection refused) while connecting to upstream, client: 172.18.0.1, server: , request: "GET /wrongport/x HTTP/1.1", upstream: "http://172.18.0.3:8001/wrongport/x", host: "127.0.0.1:18081"</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>111: Connection refused</code> は、相手のマシンには届いたが、そのポートで誰も待っていなかったという意味です。<code>upstream:</code> の宛先とポートが、アプリの待ち受け先と合っているかを見ます。</p>



<p class="wp-block-paragraph">名前（サービス名など）を間違えた場合は、502 ではなく、nginx の起動時に host not found で止まります。後の章で詳しく書きます。</p>



<p class="wp-block-paragraph">Docker の nginx で <code>127.0.0.1</code> へ転送したときも、同じ 111 の 502 になります。コンテナの中の 127.0.0.1 は nginx 自身を指すためです。</p>



<p class="is-style-icon_info wp-block-paragraph">Gunicorn をソケットファイルで動かしている場合は、<code>upstream:</code> が <code>unix:</code> で始まるパスになります。今回はソケットでは試していません。一般的には、ファイルの場所と権限を確かめます。</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/gunicorn-django-basics/">GunicornでDjangoプロジェクトをデプロイする方法【Nginx使用】</a>
						<span class="p-blogCard__excerpt">Gunicornの設定が難しすぎる… 動かすコマンドは？ 実践的な設定方法を教えて！ このような方に向けて書きました。 中小規模のDjangoアプリのデプロイによく使われるアプ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">原因③：アプリが返事をせずに接続を切る</h3>



<p class="wp-block-paragraph">つながったのに、アプリが何も返さずに接続を切った場合も 502 です。実験では、リクエストを読んだら切るだけのサーバーへ転送しました。</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">Plaintext</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>upstream prematurely closed connection while reading response header from upstream, client: 172.18.0.1, server: , request: "GET /crash/x HTTP/1.1", upstream: "http://172.18.0.2:9000/crash/x", host: "127.0.0.1:18081"</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: #D4D4D4">upstream prematurely closed connection while reading response header from upstream, client: 172.18.0.1, server: , request: "GET /crash/x HTTP/1.1", upstream: "http://172.18.0.2:9000/crash/x", host: "127.0.0.1:18081"</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>prematurely closed</code> は「返事の途中（ここでは返事の頭）で切られた」という意味です。接続まではできているので、名前やポートは合っています。</p>



<p class="wp-block-paragraph">調べるのはアプリ側です。処理中にプロセスが落ちていないか、アプリのログを見ます。一般には、メモリ不足でプロセスが強制終了されたときにも、この形になることがあります。</p>



<h3 class="wp-block-heading">原因④：アプリ側のエラーが 502 に見える</h3>



<p class="wp-block-paragraph">nginx のエラーログに何も出ていないのに 502 になることがあります。このときは、<strong>nginx ではなくアプリが 502 を返しています</strong>。</p>



<p class="wp-block-paragraph">僕も VPS にアプリを載せたとき、アプリが返す 502 に迷いました。</p>



<p class="wp-block-paragraph">Next.js から Django の API を呼ぶ部分が 502 になっていましたが、たどると Django が Host ヘッダーを 400 で断っていました。</p>



<p class="wp-block-paragraph">Next.js が裏の API の失敗を受けて、自分で 502 を返していたわけです。nginx から見れば、アプリが返した 502 をそのまま渡すだけです。</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-invalid-http-host-underscore/">Invalid HTTP_HOST headerの原因と直し方｜Django</a>
						<span class="p-blogCard__excerpt">Django に「Invalid HTTP_HOST header」と出て、400 Bad Request になる エラーに「not valid according to RFC 1034/1035」と書かれている ALLOWED_HOSTS に &#8220;*&#8221; を入&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">見分け方は、エラーログに行があるかどうかです。後で出てくる Gunicorn の 500 の実験でも、アプリが返したエラーはエラーログに出ず、アクセスログの <code>upstream_status</code> にだけ出ました。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">502 なのにエラーログが空なら、アプリのログと、そのアプリがさらに呼んでいる先を確かめてください。</p>



<h2 class="wp-block-heading">504 の原因と直し方</h2>



<p class="wp-block-paragraph">504 は、nginx がアプリを待つ時間の上限を超えたときに出ます。</p>



<h3 class="wp-block-heading">proxy_read_timeout を超えている</h3>



<p class="wp-block-paragraph">アプリにつないだあと、返事を待つ時間の上限が <code>proxy_read_timeout</code> です。nginx の既定は 60秒です。実験では3秒にして、5秒かかる処理を呼びました。</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">Nginx</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>location /short/ {
    proxy_pass http://app:8000/slow;
    proxy_read_timeout 3s;
}</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: #D4D4D4">location /short/ {</span></span>
<span class="line"><span style="color: #D4D4D4">    proxy_pass http://app:8000/slow;</span></span>
<span class="line"><span style="color: #D4D4D4">    proxy_read_timeout 3s;</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">ちょうど3.0秒で 504 になり、エラーログには次の行が出ました。</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">Plaintext</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>upstream timed out (110: Operation timed out) while reading response header from upstream, client: 172.18.0.1, server: , request: "GET /short/?5 HTTP/1.1", upstream: "http://172.18.0.3:8000/slow?5", host: "127.0.0.1:18081"</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: #D4D4D4">upstream timed out (110: Operation timed out) while reading response header from upstream, client: 172.18.0.1, server: , request: "GET /short/?5 HTTP/1.1", upstream: "http://172.18.0.3:8000/slow?5", host: "127.0.0.1:18081"</span></span></code></pre></div>



<p class="wp-block-paragraph">アクセスログでも <code>upstream_response_time=3.009</code> で、設定した3秒で切られたことが分かります。</p>



<p class="wp-block-paragraph">末尾が <code>while reading response header</code> なら、つながったあとに返事が遅かったということです。</p>



<p class="wp-block-paragraph"><code>while connecting to upstream</code> なら、つなぐところで時間切れになっています。</p>



<p class="wp-block-paragraph">つなぐ段階の上限は <code>proxy_connect_timeout</code>（既定 60秒）です。上のアプリを止めた実験の1回目は、こちらの 504 でした。</p>



<h3 class="wp-block-heading">延ばす前に処理を見直す</h3>



<p class="wp-block-paragraph">504 が出たからといって、すぐに proxy_read_timeout を延ばすのはおすすめしません。まず、その処理がなぜ遅いのかを見ます。</p>



<p class="wp-block-paragraph">ここからは一般的な考え方です。重い集計や外部 API の呼び出しを、リクエストの中で待っていないかを確かめます。時間がかかる処理は、裏で動かして結果を後で見せる形にすると、タイムアウトの心配がなくなります。</p>



<p class="wp-block-paragraph">どうしても延ばすなら、全体ではなく、遅い処理の location だけにします。上の例のように location の中に書けば、その location にだけ効きます。</p>



<h3 class="wp-block-heading">Gunicorn の timeout を超えると 502 ではなく 500 になった</h3>



<p class="wp-block-paragraph">Gunicorn には、1つのリクエストにかけられる時間の上限 <code>--timeout</code> があります。超えると、Gunicorn がワーカーを止めて起動し直します。</p>



<p class="wp-block-paragraph">この場合は 502 になると説明されることが多いのですが、手元で試すと結果は違いました。<code>--timeout 10</code> にして、15秒かかる処理を呼んだ結果です。</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">Plaintext</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>status=500 time=11.955206s
"GET /slow?15 HTTP/1.1" 500 upstream=172.18.0.3:8000 upstream_status=500 upstream_response_time=11.953 rt=11.953</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: #D4D4D4">status=500 time=11.955206s</span></span>
<span class="line"><span style="color: #D4D4D4">"GET /slow?15 HTTP/1.1" 500 upstream=172.18.0.3:8000 upstream_status=500 upstream_response_time=11.953 rt=11.953</span></span></code></pre></div>



<p class="wp-block-paragraph">ステータスは <strong>500</strong> で、nginx のエラーログには何も出ませんでした。アクセスログの <code>upstream_status=500</code> から、アプリ側が 500 を返したことが分かります。</p>



<p class="wp-block-paragraph">Gunicorn のログの最後の4行は次のとおりです。</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">Plaintext</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>    sys.exit(1)
SystemExit: 1
&#91;2026-11-19 06:05:02 +0000&#93; &#91;11&#93; &#91;INFO&#93; Worker exiting (pid: 11)
&#91;2026-11-19 06:05:02 +0000&#93; &#91;12&#93; &#91;INFO&#93; Booting worker with pid: 12</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: #D4D4D4">    sys.exit(1)</span></span>
<span class="line"><span style="color: #D4D4D4">SystemExit: 1</span></span>
<span class="line"><span style="color: #D4D4D4">[2026-11-19 06:05:02 +0000] [11] [INFO] Worker exiting (pid: 11)</span></span>
<span class="line"><span style="color: #D4D4D4">[2026-11-19 06:05:02 +0000] [12] [INFO] Booting worker with pid: 12</span></span></code></pre></div>



<p class="wp-block-paragraph">ワーカーが終了し、新しいワーカーが起動しています。nginx の proxy_read_timeout（既定 60秒）より先に、Gunicorn の10秒の上限に当たったので、Gunicorn 側で終わったわけです。</p>



<p class="is-style-icon_info wp-block-paragraph">試したのは Gunicorn 23.0.0 の同期ワーカー（既定の sync）だけです。ほかのバージョンやワーカーの種類で同じになるかは確かめていません。</p>



<p class="wp-block-paragraph">つまり、遅い処理で何が返るかは、<strong>nginx と Gunicorn のどちらの上限が短いか</strong>で決まります。</p>



<figure class="wp-block-table"><table><thead><tr><th>上限の関係</th><th>遅い処理で返るもの</th><th>見る場所</th></tr></thead><tbody><tr><td>Gunicorn の timeout が短い</td><td>500（今回の結果）</td><td>Gunicorn のログ、アクセスログの upstream_status</td></tr><tr><td>nginx の proxy_read_timeout が短い</td><td>504</td><td>nginx のエラーログの upstream timed out</td></tr></tbody></table><figcaption class="wp-element-caption">Gunicorn と nginx の上限の関係</figcaption></figure>



<p class="wp-block-paragraph">処理の時間を延ばすなら、両方をそろえて見直します。片方だけ延ばしても、もう片方の上限で切られます。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">500 が出たら、アプリのバグだけでなく、Gunicorn のログに Worker exiting が出ていないかも見てください。</p>



<h2 class="wp-block-heading">アプリを止めたまま nginx を起動すると、nginx が起動しない</h2>



<p class="wp-block-paragraph">Docker Compose で、転送先をサービス名で書いているときの話です。アプリが止まっていると、nginx は起動時に名前を引けず、起動に失敗します。</p>



<h3 class="wp-block-heading">nginx -t と reload は失敗し、古い設定のまま動き続ける</h3>



<p class="wp-block-paragraph">アプリを止めた状態で、nginx のコンテナの中で <code>nginx -t</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">Plaintext</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>nginx: &#91;emerg&#93; host not found in upstream "app" in /etc/nginx/nginx.conf:8
nginx: configuration file /etc/nginx/nginx.conf test failed</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: #D4D4D4">nginx: [emerg] host not found in upstream "app" in /etc/nginx/nginx.conf:8</span></span>
<span class="line"><span style="color: #D4D4D4">nginx: configuration file /etc/nginx/nginx.conf test failed</span></span></code></pre></div>



<p class="wp-block-paragraph">設定ファイルは書き換えていないのに、テストが失敗します。nginx は設定を読むときに、proxy_pass の名前を引いているためです。</p>



<p class="wp-block-paragraph"><code>nginx -s reload</code> も同じエラーで失敗しました。ただ、動いていた nginx は止まらず、<strong>古い設定のまま動き続けました</strong>。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">設定を直して reload したつもりでも、反映されていないことがあります。reload の後は、エラーが出ていないか必ずログを見てください。</p>



<h3 class="wp-block-heading">nginx を再起動すると起動しない</h3>



<p class="wp-block-paragraph">アプリを止めたまま <code>docker compose restart nginx</code> を実行すると、nginx は同じ <code>[emerg] host not found in upstream</code> で起動しませんでした。</p>



<p class="wp-block-paragraph">こうなると、アプリと関係のないサイトや静的ファイルまで、すべて表示できなくなります。1つの nginx で複数のサイトを受けている構成では影響が大きいです。</p>



<p class="wp-block-paragraph">アプリを起動してから nginx を起動し直すと、元どおり 200 になりました。順番を守れば直ります。</p>



<h3 class="wp-block-heading">resolver と変数で書くと、アプリが止まっていても起動する</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">Nginx</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>server {
    listen 80;
    resolver 127.0.0.11 valid=10s;

    location / {
        set $up app:8000;
        proxy_pass http://$up;/
    }
}</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: #D4D4D4">server {</span></span>
<span class="line"><span style="color: #D4D4D4">    listen 80;</span></span>
<span class="line"><span style="color: #D4D4D4">    resolver 127.0.0.11 valid=10s;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    location / {</span></span>
<span class="line"><span style="color: #D4D4D4">        set $up app:8000;</span></span>
<span class="line"><span style="color: #D4D4D4">        proxy_pass http://$up;/</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>127.0.0.11</code> は、Docker のネットワークの中で名前を答えてくれる DNS です。proxy_pass に変数を使うと、nginx は起動時ではなく、リクエストのときにこの DNS で名前を引きます。</p>



<p class="wp-block-paragraph">この設定で、アプリを止めたまま nginx を再起動すると、nginx は起動しました。リクエストは 502 になり、エラーログは次の行です。</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">Plaintext</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>app could not be resolved (3: Host not found), client: 172.18.0.1, server: , request: "GET /hello HTTP/1.1", host: "127.0.0.1:18081"</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: #D4D4D4">app could not be resolved (3: Host not found), client: 172.18.0.1, server: , request: "GET /hello HTTP/1.1", host: "127.0.0.1:18081"</span></span></code></pre></div>



<p class="wp-block-paragraph">そのあとアプリを起動すると、nginx には何もしないまま 200 が返りました。</p>



<p class="is-style-icon_info wp-block-paragraph">一般的な注意点として、proxy_pass に変数を使うと、末尾の / でパスを置き換える動きが変数なしのときと変わります。パスを置き換えている location に使うときは、アプリに届くパスを確かめてください。</p>



<h3 class="wp-block-heading">僕の VPS では resolver を使っていない</h3>



<p class="wp-block-paragraph">僕の VPS の nginx.conf は、proxy_pass にサービス名をそのまま書いていて、resolver は使っていません。</p>



<p class="wp-block-paragraph">つまり、アプリを止めたまま nginx を作り直すと、今回の実験と同じことが起きうる書き方です。</p>



<p class="wp-block-paragraph">変数なしの書き方には、名前の書き間違いに起動時に気づけるという良さもあります。resolver を使うと、間違いがリクエストのときの 502 まで見えません。</p>



<p class="wp-block-paragraph">どちらを選ぶにしても、nginx を起動し直す前に、アプリのコンテナが動いているかを <code>docker compose ps</code> で確かめると安全です。</p>



<h2 class="wp-block-heading">直したあとに確かめる</h2>



<p class="wp-block-paragraph">設定やアプリを直したら、次の順で確かめます。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>直したあとの確認</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li><code>nginx -t</code> で設定を確かめる（Docker なら <code>docker compose exec nginx nginx -t</code>）</li>



<li>reload したら、エラーログに emerg や error が出ていないかを見る</li>



<li>curl でステータスと時間を確かめる</li>



<li>アクセスログの upstream_status と upstream_response_time を見る</li>
</ol>
</div></div>



<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">ShellScript</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>curl -s -o /dev/null -w 'status=%{http_code} time=%{time_total}s\n' https://cfxlog.com/hello</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: #D4D4D4">curl -s -o /dev/null -w 'status=%{http_code} time=%{time_total}s\n' https://cfxlog.com/hello</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>-w</code> でステータスと時間だけを出すと、502 がすぐ返るのか、何秒か待って返るのかが分かります。</p>



<p class="wp-block-paragraph">過去のログから 502・504 の行だけを拾うときは、grep が便利です。</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">ShellScript</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>sudo grep -E '" (502|504) ' /var/log/nginx/access.log | tail -n 20
sudo grep -E 'upstream|emerg' /var/log/nginx/error.log | tail -n 20</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: #D4D4D4">sudo grep -E '" (502|504) ' /var/log/nginx/access.log | tail -n 20</span></span>
<span class="line"><span style="color: #D4D4D4">sudo grep -E 'upstream|emerg' /var/log/nginx/error.log | tail -n 20</span></span></code></pre></div>


<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/03/linux-grep-command-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/linux-grep-command/">【Linux】grep コマンドを使ってテキスト検索を効率化しよう！</a>
						<span class="p-blogCard__excerpt">この記事では、Linux でテキスト検索を行うためのgrepコマンドを解説します。 基本的な使い方から正規表現を使った高度な検索方法までをカバーしますので、検索に自信が&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">ログを前後まで読みたいときは less で開くと、検索しながら読めます。</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/03/linux-less-command-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/linux-less-command/">【Linux】lessコマンドでログファイルの中身を閲覧してみよう！</a>
						<span class="p-blogCard__excerpt">Linuxでファイルの中身を確認したい ログファイルを見たい ページごとに閲覧したい このような方に向けて書きました。 Linux でログファイルを閲覧しようと考えたとき、&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">よくある質問</h2>



<div class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-main">
<div class="swell-block-faq__item"><h3 class="faq_q">503 Service Unavailable とは何が違いますか？</h3><div class="faq_a">
<p class="wp-block-paragraph">ここは一般論です。503 は「いまは受け付けられない」という意味で、アプリがメンテナンス中に自分で返すほか、nginx でアクセス数を制限する limit_req の既定の返事も 503 です。</p>



<p class="wp-block-paragraph">502・504 のように、アプリとのやりとりが失敗したときのエラーではありません。503 が出たら、アプリのメンテナンス表示と、nginx の制限の設定を見てください。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">502 がたまにだけ出ます。</h3><div class="faq_a">
<p class="wp-block-paragraph">アクセスログで、502 が出た時刻を見てください。デプロイやコンテナの再起動の時刻と重なっていれば、起動の途中にリクエストが届いた可能性が高いです。</p>



<p class="wp-block-paragraph">時刻がばらばらなら、エラーログの文言を見て、アプリが落ちていないか（prematurely closed）を確かめます。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">アプリのコンテナを作り直したら、nginx の reload は要りますか？</h3><div class="faq_a">
<p class="wp-block-paragraph">今回の実験では、<code>docker compose up -d --force-recreate app</code> で作り直しても IP は変わらず、nginx はそのまま 200 を返しました。</p>



<p class="wp-block-paragraph">IP が変わる場合があるかは試していません。変数なしの proxy_pass では、nginx は起動時に引いた IP を使い続けるので、作り直しの後に 502 が続くなら、nginx を reload してください。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">proxy_read_timeout を延ばしたのに 504 が続きます。</h3><div class="faq_a">
<p class="wp-block-paragraph">書いた location に、そのリクエストが本当に当たっているかを確かめます。別の location に当たっていると、延ばした値は効きません。</p>



<p class="wp-block-paragraph">エラーログの末尾が while connecting なら、延ばすべきなのは proxy_connect_timeout です。そもそもアプリにつながっていないので、アプリの状態を先に見てください。</p>
</div></div>
</div>



<h2 class="wp-block-heading">まとめ：エラーログの1行から原因をたどる</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>502 は返事がおかしい、504 は待ちきれなかった。理由は nginx のエラーログに1行で出る</li>



<li>111: Connection refused はポートや宛先の誤り、prematurely closed はアプリが途中で切った</li>



<li>エラーログが空の 502・500 は、アプリが返したもの。アクセスログの upstream_status で分かる</li>



<li>upstream timed out は proxy_read_timeout（既定 60秒）超え。延ばす前に処理を見直す</li>



<li>Gunicorn の timeout を超えた処理は、僕の環境では 502 ではなく 500 になった</li>



<li>アプリを止めたまま nginx を起動すると、host not found で nginx が起動しない。reload は失敗して古い設定のまま動く</li>



<li>resolver と変数で書けば、アプリが止まっていても nginx は起動する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">502・504 が出たら、まずエラーログの末尾を見て、上の表のどれに当たるかを確かめてください。</p>



<p class="wp-block-paragraph">VPS を借りてから nginx でサイトを公開し、Docker で運用するまでの流れは、こちらにまとめています。</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/linux-vps-roadmap/">個人でVPSを構築する手順まとめ｜借りてからWebサイト公開・Docker運用まで5ステップ</a>
						<span class="p-blogCard__excerpt">個人で VPS を借りたいけど、何から始めればいいか分からない Web サーバーを立てて、自分のサイトを公開するまでの流れを知りたい HTTPS 化や Docker での運用まで、ど&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【解決法付き】Chrome の「Permissions policy violation: Geolocation access has been blocked」エラーとは？原因と nginx での対処方法</title>
		<link>https://cfxlog.com/code-nginx-geolocation-permission/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 06 Aug 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Other]]></category>
		<category><![CDATA[UI実装]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5248</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/code-nginx-geolocation-permission-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>Web アプリで現在地を取得する機能を作っていると、Chrome のコンソールにこのエラーが表示されることがあります。この記事を読めば、原因の切り分け方と nginx での解決方法がわかります。 最初は JavaScri [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/code-nginx-geolocation-permission-1024x538.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>「Geolocation access has been blocked」というエラーが出て、現在地取得ができない</li>



<li>JavaScript の書き方もユーザーの許可設定も間違っていないのに動かない</li>



<li>nginx で直せると聞いたが、どこに何を書けばいいかわからない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Web アプリで現在地を取得する機能を作っていると、Chrome のコンソールにこのエラーが表示されることがあります。この記事を読めば、<strong>原因の切り分け方と nginx での解決方法</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">Text</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>[Violation] Permissions policy violation: Geolocation access has been blocked because of a permissions policy applied to the current document.</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">[Violation] Permissions policy violation: Geolocation access has been blocked because of a permissions policy applied to the current document.</span></span></code></pre></div>



<p class="wp-block-paragraph">最初は JavaScript の問題かと思いがちですが、実は <strong>ブラウザ側のポリシー（Permissions-Policy）によって Geolocation API が禁止されている</strong>ことが原因です。</p>



<h2 class="wp-block-heading">位置情報がブロックされる3つのレイヤー</h2>



<p class="wp-block-paragraph">位置情報まわりのトラブルは、だいたい次の <strong>3つのレイヤー</strong> のどこかで止められています。</p>



<h3 class="wp-block-heading">①プロトコルレイヤー</h3>



<p class="wp-block-paragraph">Geolocation API は <strong>HTTPS が必須</strong>です。HTTP では、そもそも API 自体が使えません。</p>



<h3 class="wp-block-heading">②ブラウザ・ユーザー権限レイヤー</h3>



<p class="wp-block-paragraph">Chrome などが表示する「このサイトに位置情報の利用を許可しますか？」というダイアログで、ユーザーが「拒否」を選ぶと <code>PERMISSION_DENIED</code> になります。</p>



<h3 class="wp-block-heading">③サーバー側ポリシーレイヤー（Permissions-Policy）</h3>



<p class="wp-block-paragraph">レスポンスヘッダー <code>Permissions-Policy</code> で、「このページは geolocation を使っていい・ダメ」をサーバー側から定義できます。<strong>今回のエラーは、この3番目のレイヤーでブロックされているパターンです。</strong></p>



<p class="wp-block-paragraph">JavaScript の書き方が正しく、ユーザーが許可していても、サーバー側の <code>Permissions-Policy</code> で <code>geolocation=()</code> のように禁止されていると、ブラウザはそもそも Geolocation API を使わせてくれません。</p>



<p class="wp-block-paragraph">コンソールにエラーが出たら、まずは<strong>どのレイヤーで止められているか</strong>を切り分けることが大切です。</p>



<h2 class="wp-block-heading">Permissions-Policyでできること</h2>



<p class="wp-block-paragraph"><code>Permissions-Policy</code> は、<strong>「このページは、ブラウザのどの機能を使ってよいか」をサーバーが宣言するヘッダー</strong> です。</p>



<p class="wp-block-paragraph">たとえば以下について「どの origin に対して許可するか？」を細かく制御できます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>geolocation（位置情報）</li>



<li>camera（カメラ）</li>



<li>microphone（マイク）</li>



<li>fullscreen（フルスクリーン）</li>



<li>payment（決済） …など</li>
</ul>
</div></div>



<h3 class="wp-block-heading">基本の構文</h3>



<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">Text</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>Permissions-Policy: geolocation=&lt;allowlist&gt;;</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">Permissions-Policy: geolocation=&lt;allowlist>;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>&lt;allowlist&gt;</code> には、次のような値を指定できます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>()</code><br>→ だれにも許可しない（完全に禁止）</li>



<li><code>self</code><br>→ 自分自身の origin には許可する（デフォルト）</li>



<li><code>self "https://example.com/"</code><br>→ 自分と <code>https://example.com/</code> からのコンテンツにのみ許可</li>
</ul>
</div></div>



<p class="wp-block-paragraph">今回のケースでコンソールに出ていた以下は、「<strong>どこからも geolocation を使わせない</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">Text</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>Permissions-Policy: geolocation=()</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">Permissions-Policy: geolocation=()</span></span></code></pre></div>



<p class="wp-block-paragraph">また、ヘッダー自体が無い場合でも、環境や iframe 内などで <strong>デフォルト禁止になるケースがあります</strong>。</p>



<h2 class="wp-block-heading">原因の切り分け方</h2>



<p class="wp-block-paragraph">Chrome DevTools で以下を確認できます。</p>



<div class="wp-block-group has-border -border04"><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>DevTools → Network タブ</li>



<li>ページをリロード</li>



<li>どれかのリクエストをクリック</li>



<li>Headers → Response Headers を確認</li>
</ol>
</div></div>



<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">Text</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>permissions-policy: geolocation=()</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">permissions-policy: geolocation=()</span></span></code></pre></div>



<h2 class="wp-block-heading">nginxでの解決方法</h2>



<p class="wp-block-paragraph">結論：nginx のレスポンスヘッダーに geolocation を許可する設定を追加すれば解決します。</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">Text</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>add_header Permissions-Policy "geolocation=(self)";</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">add_header Permissions-Policy "geolocation=(self)";</span></span></code></pre></div>



<p class="wp-block-paragraph">これは、「このサイト自身のコンテンツ（self）では Geolocation を許可する」という指定です。<code>server</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">NGINX</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>server {
    listen 443 ssl;
    server_name example.com;

    # Geolocation を許可
    add_header Permissions-Policy "geolocation=(self)";

    # ここから下は普段の設定
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    root /var/www/example;
    index index.html index.htm;
}</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">server</span><span style="color:#D4D4D4"> {</span></span>
<span class="line"><span style="color:#569CD6">    listen </span><span style="color:#B5CEA8">443</span><span style="color:#D4D4D4"> ssl;</span></span>
<span class="line"><span style="color:#569CD6">    server_name </span><span style="color:#D4D4D4">example.com;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    # Geolocation を許可</span></span>
<span class="line"><span style="color:#569CD6">    add_header </span><span style="color:#D4D4D4">Permissions-Policy </span><span style="color:#CE9178">"geolocation=(self)"</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:#569CD6">    ssl_certificate </span><span style="color:#D4D4D4">    /etc/letsencrypt/live/example.com/fullchain.pem;</span></span>
<span class="line"><span style="color:#569CD6">    ssl_certificate_key </span><span style="color:#D4D4D4">/etc/letsencrypt/live/example.com/privkey.pem;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    root </span><span style="color:#D4D4D4">/var/www/example;</span></span>
<span class="line"><span style="color:#569CD6">    index </span><span style="color:#D4D4D4">index.html index.htm;</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">設定後は nginx を reload します。</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>sudo systemctl reload nginx</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">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">systemctl</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">reload</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nginx</span></span></code></pre></div>



<p class="wp-block-paragraph">この設定を追加すると、Chrome のコンソールに出ていたエラーは消えます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>navigator.geolocation.getCurrentPosition()</code></li>



<li>Leaflet の現在地機能</li>



<li>Google Maps API の geolocation</li>
</ul>
</div></div>



<p class="wp-block-paragraph">実際にこれらすべてが正常に動作するようになりました。</p>



<h2 class="wp-block-heading">それでも直らない場合</h2>



<p class="wp-block-paragraph">もし nginx に追加したのに解決しない場合、たとえば Cloudflare の <strong>Security → HTTP headers</strong> や、Django の middleware で <code>Permissions-Policy</code> を追加しているケースでは、ヘッダーが上書きされている可能性があります。</p>



<p class="wp-block-paragraph">もう一つ、nginx特有の落とし穴として、<strong><code>add_header</code>は同じスコープ内に自分で書いたものしか継承されない</strong>という仕様があります。<code>location</code>ブロック側で別の<code>add_header</code>を書いていると、<code>server</code>ブロックで設定した<code>Permissions-Policy</code>が丸ごと無視されることがあるので、該当する<code>location</code>にも同じ行を追記してみてください。</p>



<p class="wp-block-paragraph">DevTools のレスポンスヘッダーを必ず確認しましょう。</p>



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



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>問題</th><th>Chrome が geolocation をブロックしていた</th></tr></thead><tbody><tr><td>原因</td><td>Permissions-Policy で geolocation が無効</td></tr><tr><td>解決</td><td>nginx に <code>add_header Permissions-Policy "geolocation=(self)"</code> を追加</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Geolocation を使うサイト（現在地検索、マップアプリ、位置情報機能など）では、今後ますます Permissions-Policy の設定が重要になります。同じエラーが出た場合は、まずレスポンスヘッダーを確認してみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【開発ログ】Leaflet.markerclusterで発生した「マーカークリック時の競合問題」とその解決方法</title>
		<link>https://cfxlog.com/code-javascript-leaflet-markercluster-click/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 05 Aug 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Other]]></category>
		<category><![CDATA[UI実装]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5246</guid>

					<description><![CDATA[地図アプリを開発していると、クラスター表示（Leaflet.markercluster）と単体マーカーのクリックが競合する問題に出会うことがあります。今回、開発中のアプリの検索結果ページでもまさにこれが発生し、想定外の動 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">地図アプリを開発していると、<strong>クラスター表示（Leaflet.markercluster）と単体マーカーのクリックが競合する問題</strong>に出会うことがあります。<br/>今回、開発中のアプリの検索結果ページでもまさにこれが発生し、想定外の動作を引き起こしていました。</p>



<p class="wp-block-paragraph">Leaflet.markerclusterの基本的な導入方法は、下記の記事にまとめています。</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/code-javascript-leaflet-markercluster/">Leaflet.markerclusterの使い方｜大量マーカーをクラスタ表示で高速化</a>
						<span class="p-blogCard__excerpt">マーカーが増えると地図の表示が重くなる ピンが密集して見づらくなる Leaflet.markerclusterを使えば、近いマーカーを自動でひとまとめにし、ズームすると自動で分解し&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">この記事では、<strong>発生した問題 → 原因 → 解決策 → 実際のコード</strong>という流れでわかりやすく整理します。同じような構成のアプリを開発している方の参考になれば幸いです。</p>



<h2 class="wp-block-heading">発生した問題</h2>



<p class="wp-block-paragraph">markerclusterを使用していたのですが、次のような問題が発生しました。</p>



<ul class="wp-block-list">
<li>マーカーをクリックしたいのにクラスターが反応してズームされる</li>

<li>公園カードから特定のマーカーへジャンプすると、クラスターが展開されずポップアップが正常に開かない</li>

<li>マーカーがクラスターに属している時と単体時で挙動が不安定になる</li>
</ul>



<h2 class="wp-block-heading">原因</h2>



<p class="wp-block-paragraph">Leaflet.markercluster は内部で「クリック時にクラスターをズームする」というイベントを持っています。<br/>そのため、マーカー側で click を拾っても <strong>イベントが上位に伝播してしまい、クラスターのクリックイベントも同時に動いてしまう</strong>のです。</p>



<h2 class="wp-block-heading">解決策</h2>



<h3 class="wp-block-heading">① イベントの伝播を止める</h3>



<p class="wp-block-paragraph">Leaflet.markercluster には <code>disableClusteringAtZoom</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">JavaScript</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>disableClusteringAtZoom: 18</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C8C8C8">disableClusteringAtZoom</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">18</span></span></code></pre></div>



<p class="wp-block-paragraph">これは「ズーム18以上でクラスターを解除する」という意味ですが、カードからフォーカスする際にズームが不十分だと、<strong>クラスターが展開される前にポップアップを開こうとして失敗する</strong>ことがありました。</p>



<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">JavaScript</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>marker.on("click", function (e) {
    // クラスターへの伝播を防ぐ
    if (e.originalEvent) {
        e.originalEvent.stopPropagation();
    }
});</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#9CDCFE">marker</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">on</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"click"</span><span style="color:#D4D4D4">, </span><span style="color:#569CD6">function</span><span style="color:#D4D4D4"> (</span><span style="color:#9CDCFE">e</span><span style="color:#D4D4D4">) {</span></span>
<span class="line"><span style="color:#6A9955">    // クラスターへの伝播を防ぐ</span></span>
<span class="line"><span style="color:#C586C0">    if</span><span style="color:#D4D4D4"> (</span><span style="color:#9CDCFE">e</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">originalEvent</span><span style="color:#D4D4D4">) {</span></span>
<span class="line"><span style="color:#9CDCFE">        e</span><span style="color:#D4D4D4">.</span><span style="color:#9CDCFE">originalEvent</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">stopPropagation</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">これにより、マーカークリックイベントだけが実行され、クラスターの &#8220;zoom into cluster&#8221; が発動しなくなりました。想定通りの挙動です。</p>



<h3 class="wp-block-heading">② ズーム完了を待ってからポップアップを開く</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(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">JavaScript</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 currentZoom = map.getZoom();

// クラスターが確実に展開されるズームに設定（18以上）
const targetZoom = Math.max(currentZoom, 18);

map.setView(latLng, targetZoom);

// ズーム完了後にポップアップを表示
setTimeout(function() {
    marker.openPopup();
}, 400);</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955">// 現在のズームレベルを取得</span></span>
<span class="line"><span style="color:#569CD6">const</span><span style="color:#4FC1FF"> currentZoom</span><span style="color:#D4D4D4"> = </span><span style="color:#9CDCFE">map</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">getZoom</span><span style="color:#D4D4D4">();</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">// クラスターが確実に展開されるズームに設定（18以上）</span></span>
<span class="line"><span style="color:#569CD6">const</span><span style="color:#4FC1FF"> targetZoom</span><span style="color:#D4D4D4"> = </span><span style="color:#9CDCFE">Math</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">max</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">currentZoom</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">18</span><span style="color:#D4D4D4">);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#9CDCFE">map</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">setView</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">latLng</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">targetZoom</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:#DCDCAA">setTimeout</span><span style="color:#D4D4D4">(</span><span style="color:#569CD6">function</span><span style="color:#D4D4D4">() {</span></span>
<span class="line"><span style="color:#9CDCFE">    marker</span><span style="color:#D4D4D4">.</span><span style="color:#DCDCAA">openPopup</span><span style="color:#D4D4D4">();</span></span>
<span class="line"><span style="color:#D4D4D4">}, </span><span style="color:#B5CEA8">400</span><span style="color:#D4D4D4">);</span></span></code></pre></div>



<p class="wp-block-paragraph"><strong>ズームを十分に上げ → クラスターを展開 → その後にポップアップ表示</strong><br/>という流れにすることで、安定した挙動が得られました。</p>



<p class="wp-block-paragraph">なお<code>setTimeout</code>の400msは決め打ちの待ち時間で、ズームアニメーションの完了を厳密に検知しているわけではありません。<code>map.once("zoomend", ...)</code>でズーム完了イベントを拾う方法のほうが本来はきれいですが、今回は素早く直したかったのでこの形に落ち着きました。</p>



<h2 class="wp-block-heading">得られた効果</h2>



<p class="wp-block-paragraph">上記2つの対処によって、次の改善が実現しました。</p>



<ul class="wp-block-list">
<li>マーカークリック時に勝手にズームされることがなくなった</li>

<li>クラスターとマーカーのイベント干渉が消えた</li>

<li>公園カードからマーカーへフォーカスした際の UI が確実に動くようになった</li>

<li>マーカーのポップアップが安定して開くようになった</li>
</ul>



<p class="wp-block-paragraph">地味ですが、ユーザー体験に直結する重要な改善です。</p>



<h2 class="wp-block-heading">まとめ：再発防止チェックリスト</h2>



<p class="wp-block-paragraph">Leaflet.markercluster を使う人向けに、再発防止のチェックリストも載せます。</p>



<ul class="wp-block-list">
<li><strong>イベント伝播</strong>：ほぼ確実に衝突の原因になる</li>

<li><strong>クラスター解除ズーム</strong>：最低ズームを理解しておく</li>

<li><strong>ポップアップ表示タイミング</strong>：ズーム完了前に openPopup すると失敗する</li>
</ul>



<p class="wp-block-paragraph">この3つを理解していないと、意図しない挙動が簡単に発生します。今回の修正は、まさにその3点を正しくコントロールすることで解決した例でした。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>VBAエラー処理・デバッグ完全ガイド｜On Error GoTo・Debug.Print・ログ出力の使い方</title>
		<link>https://cfxlog.com/vba-error-handling-best-practices/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 18 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[VBA]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=101</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/vba-error-handling-best-practices-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>このような疑問にお答えします。 Excel VBAって手軽にプログラムを組める一方で、エラーハンドリングをきちんと組んであるコードが少ない印象を受けています。 ただ、いざエラー処理を追加しようと思っても「一体どうやって組 [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/vba-error-handling-best-practices-1024x538.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>エラハンドリングのベストプラクティスが知りたい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">Excel VBAって手軽にプログラムを組める一方で、エラーハンドリングをきちんと組んであるコードが少ない印象を受けています。</p>



<p class="wp-block-paragraph">ただ、いざエラー処理を追加しようと思っても「一体どうやって組めば良いエラー処理ができるのか…」と途方に暮れてしまう方も多いと思います。</p>



<p class="wp-block-paragraph"><code>On Error GoTo</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>エラーの種類ごとに挙動を変える方法は？</li>



<li>カスタムエラーを定義したいのだが…</li>



<li>どんなエラーメッセージを設定したら良い？</li>
</ul>
</div></div>



<p class="wp-block-paragraph">本記事の内容が「答え」とまでは言いませんが、僕が普段VBAコードを組む際の考え方をお伝えできたらと思います。</p>



<p class="wp-block-paragraph">エラーハンドリングについて漠然とした不安がある方は、ぜひ参考にしてください。</p>



<h2 class="wp-block-heading">開発中の原因調査はDebug.Print＋イミディエイトウィンドウで十分</h2>



<p class="wp-block-paragraph">本番向けのエラー処理を組む前段階として、開発中に「なぜ想定通り動かないのか」を調べる作業があります。</p>



<p class="wp-block-paragraph">ここは凝ったデバッグツールを持ち出さなくても、<code>Debug.Print</code>とイミディエイトウィンドウの組み合わせで大抵は事足ります。僕もプロジェクトによって使うツールは変えますが、原因調査の第一手はいつもこれです。</p>



<h3 class="wp-block-heading">変数の中身をイミディエイトウィンドウに流す</h3>



<p class="wp-block-paragraph">怪しい変数の値をその場で<code>Debug.Print</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">VB</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>Sub CheckValue()
    Dim i As Long
    For i = 1 To 5
        Debug.Print "i = " &amp; i &amp; " / result = " &amp; i * 10
    Next i
End Sub</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> CheckValue</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> i </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Long</span></span>
<span class="line"><span style="color:#C586C0">    For</span><span style="color:#9CDCFE"> i</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">1</span><span style="color:#C586C0"> To</span><span style="color:#B5CEA8"> 5</span></span>
<span class="line"><span style="color:#D4D4D4">        Debug.Print </span><span style="color:#CE9178">"i = "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> i</span><span style="color:#D4D4D4"> &amp; </span><span style="color:#CE9178">" / result = "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> i</span><span style="color:#D4D4D4"> * </span><span style="color:#B5CEA8">10</span></span>
<span class="line"><span style="color:#C586C0">    Next</span><span style="color:#D4D4D4"> i</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">イミディエイトウィンドウは<code>Ctrl + G</code>で開けます。出力が溜まってきたらウィンドウ内で全選択して削除すれば、まっさらな状態に戻せます。</p>



<h3 class="wp-block-heading">どこからの出力か分かるように目印を付ける</h3>



<p class="wp-block-paragraph">複数のプロシージャで同時に<code>Debug.Print</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">VB</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>Debug.Print "[ImportData] row=" &amp; i &amp; " status=" &amp; status</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">Debug.Print </span><span style="color:#CE9178">"[ImportData] row="</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> i</span><span style="color:#D4D4D4"> &amp; </span><span style="color:#CE9178">" status="</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> status</span></span></code></pre></div>



<p class="wp-block-paragraph">ここまでは、開発中に自分で原因を追うための話です。実際に配布・運用するマクロでは、こうした場当たり的な確認だけでなく、構造立ったエラー処理が必要になります。</p>



<h2 class="wp-block-heading">エラーハンドリングのベストプラクティス</h2>



<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>カスタムエラーの定義</li>



<li>エラーを発生させる</li>



<li>エラー処理を構造化</li>



<li>ログ記録をする</li>



<li>上位モジュールに伝播させる</li>



<li>クリーンアップ処理</li>



<li>ユーザーにエラー内容を伝える</li>
</ul>
</div></div>



<p class="wp-block-paragraph">一つ一つは大して難しくないので、順を追って説明していきます。</p>



<h3 class="wp-block-heading">カスタムエラーの定義</h3>



<p class="wp-block-paragraph">VBAではデフォルトでもエラーが定義されていますが、それ以外にカスタムでエラーを定義させたい場合があります。</p>



<p class="wp-block-paragraph">そのような時にはシステム定義のエラー番号（1～65535）との衝突を避けるために、独自の範囲を設定しましょう。</p>



<p class="wp-block-paragraph">一般的には100000以上の数値を指定することが多いです。</p>



<p class="wp-block-paragraph">さらに付け加えると、エラーのカテゴリごとに1000区切りなどで番号を振ると管理が楽になります。</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">VB</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>' データベース関連のエラー
Public Const ERR_DB_CONNECTION_FAILED As Long = 100000
Public Const ERR_DB_QUERY_FAILED As Long = 100001

' ファイル操作関連のエラー
Public Const ERR_FILE_NOT_FOUND As Long = 101000
Public Const ERR_FILE_READ_FAILED As Long = 101001

' ユーザー認証関連のエラー
Public Const ERR_USER_NOT_AUTHORIZED As Long = 102000
Public Const ERR_USER_NOT_FOUND As Long = 102001

' ネットワーク関連のエラー
Public Const ERR_NETWORK_TIMEOUT As Long = 103000
Public Const ERR_NETWORK_UNREACHABLE As Long = 103001</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955">' データベース関連のエラー</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_DB_CONNECTION_FAILED As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">100000</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_DB_QUERY_FAILED As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">100001</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">' ファイル操作関連のエラー</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_FILE_NOT_FOUND As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">101000</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_FILE_READ_FAILED As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">101001</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">' ユーザー認証関連のエラー</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_USER_NOT_AUTHORIZED As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">102000</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_USER_NOT_FOUND As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">102001</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">' ネットワーク関連のエラー</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_NETWORK_TIMEOUT As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">103000</span></span>
<span class="line"><span style="color:#569CD6">Public Const </span><span style="color:#D4D4D4">ERR_NETWORK_UNREACHABLE As </span><span style="color:#4EC9B0">Long</span><span style="color:#D4D4D4"> = </span><span style="color:#B5CEA8">103001</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">エラー番号のルールはドキュメント化しておくと、チーム全体で共有しやすいです。</p>



<h3 class="wp-block-heading">エラーを発生させる</h3>



<p class="wp-block-paragraph"><code>Err.Raise</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">VB</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>Err.Raise ERR_DB_CONNECTION_FAILED, "ConnectDatabase", "データベースへの接続に失敗しました。"</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">Err.Raise ERR_DB_CONNECTION_FAILED, </span><span style="color:#CE9178">"ConnectDatabase"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"データベースへの接続に失敗しました。"</span></span></code></pre></div>



<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>エラー番号</td></tr><tr><td>第２引数</td><td>エラーの発生源</td></tr><tr><td>第３引数</td><td>エラーの説明文</td></tr></tbody></table><figcaption class="wp-element-caption">各引数の内容</figcaption></figure>



<p class="wp-block-paragraph"><code>Err</code>オブジェクトの内容にあたる部分を作っていく工程になります。</p>



<h3 class="wp-block-heading">エラー処理を構造化</h3>



<p class="wp-block-paragraph"><code>Err.Raise</code>で発生させたエラーを補足するためのコードを追加します。</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 is-style-good_list">
<li><code>On Error GoTo</code>でエラーハンドラーを設定</li>



<li><code>Select Case</code>でエラーごとに処理を変える</li>
</ul>
</div></div>



<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(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">VB</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>Sub ConnectDatabase()
    On Error GoTo ErrorHandler

    ' データベースエラーを発生させる
    Err.Raise ERR_DB_CONNECTION_FAILED, "ConnectDatabase", "データベースへの接続に失敗しました。"

    Exit Sub

ErrorHandler:
    Select Case Err.Number
        Case ERR_DB_CONNECTION_FAILED
            MsgBox "ERR_DB_CONNECTION_FAILED: " &amp; Err.Description
        Case ERR_DB_QUERY_FAILED
            MsgBox "ERR_DB_QUERY_FAILED: " &amp; Err.Description
        Case Else
            MsgBox "予期せぬエラー: " &amp; Err.Description
    End Select

    Err.Clear
End Sub</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ConnectDatabase</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    On Error GoTo </span><span style="color:#D4D4D4">ErrorHandler</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' データベースエラーを発生させる</span></span>
<span class="line"><span style="color:#D4D4D4">    Err.Raise ERR_DB_CONNECTION_FAILED, </span><span style="color:#CE9178">"ConnectDatabase"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"データベースへの接続に失敗しました。"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">    Exit Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">ErrorHandler:</span></span>
<span class="line"><span style="color:#C586C0">    Select</span><span style="color:#C586C0"> Case</span><span style="color:#D4D4D4"> Err.Number</span></span>
<span class="line"><span style="color:#C586C0">        Case</span><span style="color:#D4D4D4"> ERR_DB_CONNECTION_FAILED</span></span>
<span class="line"><span style="color:#DCDCAA">            MsgBox</span><span style="color:#CE9178"> "ERR_DB_CONNECTION_FAILED: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.Description</span></span>
<span class="line"><span style="color:#C586C0">        Case</span><span style="color:#D4D4D4"> ERR_DB_QUERY_FAILED</span></span>
<span class="line"><span style="color:#DCDCAA">            MsgBox</span><span style="color:#CE9178"> "ERR_DB_QUERY_FAILED: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.Description</span></span>
<span class="line"><span style="color:#C586C0">        Case</span><span style="color:#C586C0"> Else</span></span>
<span class="line"><span style="color:#DCDCAA">            MsgBox</span><span style="color:#CE9178"> "予期せぬエラー: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.Description</span></span>
<span class="line"><span style="color:#C586C0">    End Select</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    Err.</span><span style="color:#DCDCAA">Clear</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の<code>Case Else</code>では<code>Description</code>を定義していないのでは？と思われるかもしれませんが、問題なしです。</p>



<p class="wp-block-paragraph">というのも<code>Case Else</code>に入る場合はシステムエラーの場合なので、システム側で用意されたエラーメッセージが自動的に入るためです。</p>



<p class="wp-block-paragraph">もちろん、カスタムエラーならErr.Raiseの第二引数で詳細を指定しているので、こちらも問題なしですね。</p>



<h3 class="wp-block-heading">ログ記録をする</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(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">VB</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>Sub WriteErrorLog(ByVal errNumber As Long, ByVal errSource As String, ByVal errDescription As String)
    Dim logPath As String
    Dim fileNum As Integer

    logPath = ThisWorkbook.Path &amp; "\error_log.txt"
    fileNum = FreeFile

    Open logPath For Append As #fileNum
    Print #fileNum, Format(Now, "yyyy-mm-dd hh:nn:ss") &amp; vbTab &amp; errNumber &amp; vbTab &amp; errSource &amp; vbTab &amp; errDescription
    Close #fileNum
End Sub</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> WriteErrorLog</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">ByVal errNumber As Long, ByVal errSource As String, ByVal errDescription As String</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> logPath </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">String</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> fileNum </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">Integer</span></span>
<span class="line"></span>
<span class="line"><span style="color:#9CDCFE">    logPath</span><span style="color:#D4D4D4"> = ThisWorkbook.</span><span style="color:#9CDCFE">Path</span><span style="color:#D4D4D4"> &amp; </span><span style="color:#CE9178">"\error_log.txt"</span></span>
<span class="line"><span style="color:#9CDCFE">    fileNum</span><span style="color:#D4D4D4"> =</span><span style="color:#9CDCFE"> FreeFile</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    Open logPath </span><span style="color:#C586C0">For</span><span style="color:#D4D4D4"> Append As #fileNum</span></span>
<span class="line"><span style="color:#D4D4D4">    Print #fileNum, </span><span style="color:#DCDCAA">Format</span><span style="color:#D4D4D4">(</span><span style="color:#DCDCAA">Now</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"yyyy-mm-dd hh:nn:ss"</span><span style="color:#D4D4D4">) &amp;</span><span style="color:#9CDCFE"> vbTab</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> errNumber</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> vbTab</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> errSource</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> vbTab</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"> errDescription</span></span>
<span class="line"><span style="color:#D4D4D4">    Close #fileNum</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>For Append</code>で開くことで、既存のログを上書きせずに追記していきます。ErrorHandler側からは<code>Call WriteErrorLog(Err.Number, Err.Source, Err.Description)</code>のように渡すだけで使えます。</p>



<h3 class="wp-block-heading">上位モジュールに伝播させる</h3>



<p class="wp-block-paragraph">呼び出し元のモジュールがある場合には、必要に応じて<code>Err.Raise</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">VB</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>If Err.Number = ERR_DB_CONNECTION_FAILED Then
    ' エラー処理
    Err.Raise Err.Number, Err.Source, Err.Description
End If</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">If</span><span style="color:#D4D4D4"> Err.</span><span style="color:#9CDCFE">Number</span><span style="color:#D4D4D4"> =</span><span style="color:#9CDCFE"> ERR_DB_CONNECTION_FAILED</span><span style="color:#C586C0"> Then</span></span>
<span class="line"><span style="color:#6A9955">    ' エラー処理</span></span>
<span class="line"><span style="color:#D4D4D4">    Err.Raise Err.Number, Err.Source, Err.Description</span></span>
<span class="line"><span style="color:#C586C0">End If</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合には、下位モジュールではエラーを上位に伝播させるだけで<code>Case</code>文などは使いません。</p>



<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(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">VB</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>Sub UpperLevelFunction()
    On Error GoTo ErrorHandler
    
    ' この関数でエラー発生
    Call LowerLevelFunction()
    
    ' 正常終了時の処理
    MsgBox "処理が正常に完了しました"
    Exit Sub

ErrorHandler:
    ' 上位モジュールでのエラー処理
    Select Case Err.Number
        Case ERR_DB_CONNECTION_FAILED
            MsgBox "DB接続エラーが発生しました: " &amp; Err.Description
        Case ERR_DB_QUERY_FAILED
            MsgBox "DBクエリエラーが発生しました: " &amp; Err.Description
        Case Else
            MsgBox "予期せぬエラーが発生しました: " &amp; Err.Description &amp; " (エラー番号: " &amp; Err.Number &amp; ")"
    End Select
    
    ' エラー情報をクリア
    Err.Clear
End Sub</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> UpperLevelFunction</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    On Error GoTo </span><span style="color:#D4D4D4">ErrorHandler</span></span>
<span class="line"><span style="color:#D4D4D4">    </span></span>
<span class="line"><span style="color:#6A9955">    ' この関数でエラー発生</span></span>
<span class="line"><span style="color:#569CD6">    Call </span><span style="color:#DCDCAA">LowerLevelFunction</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#D4D4D4">    </span></span>
<span class="line"><span style="color:#6A9955">    ' 正常終了時の処理</span></span>
<span class="line"><span style="color:#DCDCAA">    MsgBox</span><span style="color:#CE9178"> "処理が正常に完了しました"</span></span>
<span class="line"><span style="color:#C586C0">    Exit Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">ErrorHandler:</span></span>
<span class="line"><span style="color:#6A9955">    ' 上位モジュールでのエラー処理</span></span>
<span class="line"><span style="color:#C586C0">    Select</span><span style="color:#C586C0"> Case</span><span style="color:#D4D4D4"> Err.Number</span></span>
<span class="line"><span style="color:#C586C0">        Case</span><span style="color:#D4D4D4"> ERR_DB_CONNECTION_FAILED</span></span>
<span class="line"><span style="color:#DCDCAA">            MsgBox</span><span style="color:#CE9178"> "DB接続エラーが発生しました: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.Description</span></span>
<span class="line"><span style="color:#C586C0">        Case</span><span style="color:#D4D4D4"> ERR_DB_QUERY_FAILED</span></span>
<span class="line"><span style="color:#DCDCAA">            MsgBox</span><span style="color:#CE9178"> "DBクエリエラーが発生しました: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.Description</span></span>
<span class="line"><span style="color:#C586C0">        Case</span><span style="color:#C586C0"> Else</span></span>
<span class="line"><span style="color:#DCDCAA">            MsgBox</span><span style="color:#CE9178"> "予期せぬエラーが発生しました: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.</span><span style="color:#9CDCFE">Description</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> </span><span style="color:#CE9178">" (エラー番号: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.</span><span style="color:#9CDCFE">Number</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> </span><span style="color:#CE9178">")"</span></span>
<span class="line"><span style="color:#C586C0">    End Select</span></span>
<span class="line"><span style="color:#D4D4D4">    </span></span>
<span class="line"><span style="color:#6A9955">    ' エラー情報をクリア</span></span>
<span class="line"><span style="color:#D4D4D4">    Err.</span><span style="color:#DCDCAA">Clear</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<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(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">VB</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>Sub LowerLevelFunction()
    On Error GoTo ErrorHandler

    ' 処理
    Err.Raise 1001, "LowerLevelFunction", "下位モジュールでのエラー"
    Exit Sub

ErrorHandler:
    MsgBox "エラー: " &amp; Err.Description
    Err.Clear
    Exit Sub
End Sub</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> LowerLevelFunction</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    On Error GoTo </span><span style="color:#D4D4D4">ErrorHandler</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 処理</span></span>
<span class="line"><span style="color:#D4D4D4">    Err.Raise </span><span style="color:#B5CEA8">1001</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"LowerLevelFunction"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"下位モジュールでのエラー"</span></span>
<span class="line"><span style="color:#C586C0">    Exit Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">ErrorHandler:</span></span>
<span class="line"><span style="color:#DCDCAA">    MsgBox</span><span style="color:#CE9178"> "エラー: "</span><span style="color:#D4D4D4"> &amp;</span><span style="color:#9CDCFE"></span><span style="color:#D4D4D4"> Err.Description</span></span>
<span class="line"><span style="color:#D4D4D4">    Err.</span><span style="color:#DCDCAA">Clear</span></span>
<span class="line"><span style="color:#C586C0">    Exit Sub</span></span>
<span class="line"><span style="color:#569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>Err.Clear</code>することで、上位モジュールにエラーが伝播しません。</p>



<h3 class="wp-block-heading">クリーンアップ処理</h3>



<p class="wp-block-paragraph">プロシージャ内で使われたリソースの解放なども、忘れずに行うようにします。</p>



<p class="wp-block-paragraph">例えば以下のように<code>ExitSub</code>ラベルを<code>finally</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">VB</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>Sub ConnectDatabase()
    On Error GoTo ErrorHandler

    ' 正常終了時の処理
    Dim conn As ADODB.Connection
    Set conn = New ADODB.Connection
    conn.Open "connection string"

    GoTo ExitSub

ErrorHandler:
    ' エラー処理
    Resume ExitSub

ExitSub:
    If Not conn Is Nothing Then
        If conn.State = adStateOpen Then conn.Close
        Set conn = Nothing
    End If
    Exit Sub</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">Sub</span><span style="color:#DCDCAA"> ConnectDatabase</span><span style="color:#D4D4D4">()</span></span>
<span class="line"><span style="color:#569CD6">    On Error GoTo </span><span style="color:#D4D4D4">ErrorHandler</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    ' 正常終了時の処理</span></span>
<span class="line"><span style="color:#569CD6">    Dim</span><span style="color:#9CDCFE"> conn </span><span style="color:#D4D4D4">As </span><span style="color:#4EC9B0">ADODB</span><span style="color:#D4D4D4">.Connection</span></span>
<span class="line"><span style="color:#569CD6">    Set </span><span style="color:#9CDCFE">conn</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> New </span><span style="color:#D4D4D4">ADODB.Connection</span></span>
<span class="line"><span style="color:#D4D4D4">    conn.Open </span><span style="color:#CE9178">"connection string"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    GoTo ExitSub</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">ErrorHandler:</span></span>
<span class="line"><span style="color:#6A9955">    ' エラー処理</span></span>
<span class="line"><span style="color:#D4D4D4">    Resume ExitSub</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">ExitSub:</span></span>
<span class="line"><span style="color:#C586C0">    If</span><span style="color:#D4D4D4"> Not conn Is</span><span style="color:#569CD6"> Nothing</span><span style="color:#C586C0"> Then</span></span>
<span class="line"><span style="color:#C586C0">        If</span><span style="color:#D4D4D4"> conn.</span><span style="color:#9CDCFE">State</span><span style="color:#D4D4D4"> =</span><span style="color:#9CDCFE"> adStateOpen</span><span style="color:#C586C0"> Then</span><span style="color:#D4D4D4"> conn.Close</span></span>
<span class="line"><span style="color:#569CD6">        Set </span><span style="color:#9CDCFE">conn</span><span style="color:#D4D4D4"> =</span><span style="color:#569CD6"> Nothing</span></span>
<span class="line"><span style="color:#C586C0">    End If</span></span>
<span class="line"><span style="color:#C586C0">    Exit Sub</span></span></code></pre></div>



<h3 class="wp-block-heading">ユーザーにエラー内容を伝える</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">VB</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>MsgBox "データの保存中にエラーが発生しました。ネットワーク接続を確認してください。", vbExclamation, "エラー"</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;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">MsgBox</span><span style="color:#CE9178"> "データの保存中にエラーが発生しました。ネットワーク接続を確認してください。"</span><span style="color:#D4D4D4">,</span><span style="color:#9CDCFE"> vbExclamation</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"エラー"</span></span></code></pre></div>



<p class="wp-block-paragraph">実装側だとどうしても専門的な言葉になってしまいがちですが、利用者の立場に立って平易な言葉で内容を伝えるようにしましょう。</p>



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



<p class="wp-block-paragraph">エラーハンドリングは型を身につけてしまえば、そこまで恐れることもないかと思っています。</p>



<p class="wp-block-paragraph">開発中はDebug.Printで手早く原因を探り、本番運用ではログをファイルに残す。この使い分けだけでも、エラーとの付き合い方はだいぶ楽になります。</p>



<p class="wp-block-paragraph">まずは本記事の内容を実践していただき、合わない部分を改善しつつ自分なりのベストプラクティスを作り上げていただけたらと思います。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Docker + nginx-proxy】Let&#8217;s Encrypt 証明書が何度も発行される原因と対策</title>
		<link>https://cfxlog.com/docker-nginx-proxy-letsencrypt/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 21 Dec 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[Docker]]></category>
		<category><![CDATA[HTTPS]]></category>
		<category><![CDATA[nginx]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4874</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/docker-nginx-proxy-letsencrypt.jpg" class="webfeedsFeaturedVisual" /></p>ところが、構成ミスやDNS未設定などにより証明書の自動発行がループしてしまい、Let&#8217;s Encrypt の レートリミット（制限）に引っかかることがあります。 今回は実際に起こったケースをもとに、その原因と [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/docker-nginx-proxy-letsencrypt.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">ところが、構成ミスやDNS未設定などにより<strong>証明書の自動発行がループ</strong>してしまい、Let&#8217;s Encrypt の <strong>レートリミット（制限）に引っかかる</strong>ことがあります。</p>



<p class="wp-block-paragraph">今回は実際に起こったケースをもとに、その原因と対応策を解説します。</p>



<h2 class="wp-block-heading">レートリミットに引っかかる原因</h2>



<p class="wp-block-paragraph">まずは原因から解説します。</p>



<h3 class="wp-block-heading">nginx-proxyの構成</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(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">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:
  nginx-proxy:
    image: jwilder/nginx-proxy:alpine
    container_name: nginx-proxy
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro
      - ./certs:/etc/nginx/certs:rw
      - ./acme:/etc/acme.sh
      - ./vhost.d:/etc/nginx/vhost.d
      - ./html:/usr/share/nginx/html
    networks:
      - proxy

  letsencrypt:
    image: jrcs/letsencrypt-nginx-proxy-companion
    container_name: nginx-letsencrypt
    restart: always
    environment:
      - NGINX_PROXY_CONTAINER=nginx-proxy
      - DEFAULT_EMAIL=tatuya.220@outlook.jp
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./certs:/etc/nginx/certs:rw
      - ./acme:/etc/acme.sh
      - ./vhost.d:/etc/nginx/vhost.d
      - ./html:/usr/share/nginx/html
    depends_on:
      - nginx-proxy
    networks:
      - proxy

networks:
  proxy:
    external: true</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">nginx-proxy</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">jwilder/nginx-proxy:alpine</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">container_name</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">nginx-proxy</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">restart</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">always</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">ports</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">&quot;80:80&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">&quot;443:443&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">/var/run/docker.sock:/tmp/docker.sock:ro</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./certs:/etc/nginx/certs:rw</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./acme:/etc/acme.sh</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./vhost.d:/etc/nginx/vhost.d</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./html:/usr/share/nginx/html</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">networks</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">proxy</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">letsencrypt</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">jrcs/letsencrypt-nginx-proxy-companion</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">container_name</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">nginx-letsencrypt</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">restart</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">always</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">NGINX_PROXY_CONTAINER=nginx-proxy</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">DEFAULT_EMAIL=tatuya.220@outlook.jp</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">/var/run/docker.sock:/var/run/docker.sock:ro</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./certs:/etc/nginx/certs:rw</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./acme:/etc/acme.sh</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./vhost.d:/etc/nginx/vhost.d</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./html:/usr/share/nginx/html</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">depends_on</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">nginx-proxy</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">networks</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">proxy</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">networks</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">proxy</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">external</span><span style="color: #D4D4D4">: </span><span style="color: #569CD6">true</span></span></code></pre></div>



<p class="wp-block-paragraph">ボリューム設定は次のようになっているので、証明書やacmeの作業ファイルは永続化されています。</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>./certs</code>: 証明書（<code>.crt</code>, <code>.key</code>）を保存</li>



<li><code>./acme</code>: ACMEアカウント、チャレンジ一時ファイル</li>



<li><code>./vhost.d</code>, <code>./html</code>: HTTP-01 チャレンジ対応、vhost個別設定</li>
</ul>
</div></div>



<p class="wp-block-paragraph">つまり、再起動しても証明書が消える構成ではなく、問題なしです。</p>



<h3 class="wp-block-heading">証明書が何度も発行される原因</h3>



<p class="wp-block-paragraph">大きく二つの原因があるようです。</p>



<h4 class="wp-block-heading">1. DNSが未設定（NXDOMAIN）</h4>



<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">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>NXDOMAIN looking up A for api.example.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: #DCDCAA">NXDOMAIN</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">looking</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">A</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">for</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">api.example.com</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合は<code>api.example.com</code>に Aレコードが無いため、Let&#8217;s Encrypt の認証が通らずに再試行が続きます。</p>



<p class="wp-block-paragraph">対策としては、VPSの管理画面などでAレコードをサーバーに向ける必要があります。</p>



<h4 class="wp-block-heading">2. 短期間で証明書の再発行が続く</h4>



<p class="wp-block-paragraph">Let&#8217;s Encrypt では同一ドメインに対して <strong>7日間で5回まで</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>Error creating new order. Le_OrderFinalize not found.
detail: "too many certificates (5) already issued for this exact set of identifiers..."
status: 429</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">Error</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">creating</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">new</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">order.</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Le_OrderFinalize</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">not</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">found.</span></span>
<span class="line"><span style="color: #DCDCAA">detail:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;too many certificates (5) already issued for this exact set of identifiers...&quot;</span></span>
<span class="line"><span style="color: #DCDCAA">status:</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">429</span></span></code></pre></div>



<p class="wp-block-paragraph">上記のようなエラーが出たら、しばらく時間を置く必要があります。</p>



<h2 class="wp-block-heading">レートリミットに引っかかってしまったら？</h2>



<p class="wp-block-paragraph">レートリミットに引っかかった場合の対処法をご説明します。</p>



<h3 class="wp-block-heading">次のリトライ可能時刻を確認する</h3>



<p class="wp-block-paragraph"><code>docker logs</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">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>"detail": "too many certificates (5) already issued for this exact set of identifiers in the last 168h0m0s, retry after 2025-07-16 20:47:21 UTC"</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">&quot;detail&quot;</span><span style="color: #DCDCAA">:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;too many certificates (5) already issued for this exact set of identifiers in the last 168h0m0s, retry after 2025-07-16 20:47:21 UTC&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の場合だと、次回の証明書発行は 2025年7月16日 20:47:21 UTC（日本時間 7月17日 5:47頃）以降に可能と分かります。</p>



<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 stop nginx-letsencrypt</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</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">stop</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nginx-letsencrypt</span></span></code></pre></div>



<h3 class="wp-block-heading">DNSレコードが向いているかを調べる</h3>



<p class="wp-block-paragraph">DNSレコードがサーバーに向いていないと、証明書取得は失敗します。</p>



<p class="wp-block-paragraph"><code>dig</code> コマンドでDNSを確認できます。</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>dig +short api.example.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: #DCDCAA">dig</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+short</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">api.example.com</span></span></code></pre></div>



<p class="wp-block-paragraph">返答が無い場合（空欄）はDNSが未設定なので、VPS管理画面などで設定が必要です。</p>



<p class="wp-block-paragraph">また、設定してから浸透まで少し時間がかかります。設定後しばらく経ってから<code>dig</code>コマンドで確認するのが確実です。</p>



<h2 class="wp-block-heading">おわりに</h2>



<p class="wp-block-paragraph">Let&#8217;s Encrypt は無料かつ強力なSSL証明書取得システムですが、<strong>自動化構成では想定外の再発行ループ</strong>が起きがちです。</p>



<p class="wp-block-paragraph">DNS設定やボリュームの永続化、ステージング環境の活用などを意識することで、安全に運用できるようになります。</p>



<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>DNS設定の事前確認</td><td>各サブドメインに正しくAレコードを設定する</td></tr><tr><td>リトライ制御</td><td>レートリミットにかかったら <code>letsencrypt</code> コンテナを一時停止</td></tr><tr><td>証明書の再利用</td><td><code>./certs</code> などの永続ボリュームを削除しないこと</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">迂回ルートとしてステージング環境を使う方法もありますが、今回は割愛しました。</p>



<p class="wp-block-paragraph">またの機会にご説明できればと思います。</p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
