エラーコード: HTTP 401 Unauthorized とは

HTTP 401 Unauthorized とは

Webサーバーがユーザーに対して、「このページを見るには、正しいIDとパスワード（またはトークン）を出してください」と要求している、あるいは「提出されたパスワードが間違っています」 と伝えているステータスコードです。

Webサイトにアクセスした際、画面に「ユーザー名」と「パスワード」を入れる小さなポップアップが出た経験があると思います（これがよくある401エラーの引き金となる Basic認証 です）。

「403 Forbidden」との決定的違い

エンジニア初心者によくある勘違いですが、401と403は意味が全く異なります。

• 401 Unauthorized (未認証): 「あなたは誰ですか？ パスワード（身分証）を見せてください」という状態。パスワードさえ正しく入力すれば入れてもらえます。
• 403 Forbidden (権限不足によるアクセス拒否): 「あなたが誰かは身分証で確認しました。でも、あなたにはここに入る権限がありません（VIP専用ルームです）、帰ってください」という状態。これ以上どうしようもありません。

現場での代表的な401エラー原因

1. Basic認証のパスワード間違い 開発中のテストサイトや、管理画面にかけられた「Basic認証（.htpasswdファイルなどによる簡易ロック）」において、入力したパスワードが間違っていると401が返ります。
2. APIの認証トークン (JWT/Bearer Token) 切れ・未付与 フロントエンド（Reactなど）からバックエンドのAPI通信を行う際、HTTPヘッダーの Authorization に正しいトークンを含め忘れたり、トークンの有効期限が切れていると、システムが「誰の要求か分からない」として401で弾き返します。