一般的なエラー
HTTPエラー
401 Unauthorized
| 症状 | APIリクエストが401を返す、またはUIが予期せずログインページにリダイレクトされる |
| 原因 | OAuth2セッションが期限切れか、トークンが無効 |
| 対処方法 | ログアウトして再度ログインしてください。再ログイン後も問題が続く場合は、OpSeeドメインのブラウザCookieとlocalStorageをクリアしてから再度ログインしてください。詳細はログインの問題を参照してください。 |
403 Forbidden
| 症状 | ページは読み込まれるがデータが表示されない、またはアクションが403エラーを返す |
| 原因 | お使いのKeycloakアカウントに、このリソースに必要なロールがありません |
| 対処方法 | Keycloak管理者に連絡してロール割り当てを確認してください。プロフィール → ロールと権限で現在のロールを確認できます。よく必要となるロール: menu:production、equipment:view、menu:admin。 |
404 Not Found
| 症状 | ページまたはAPIエンドポイントが404を返す |
| 原因 | URLが存在しない(タイプミス、古いブックマーク)、またはこのインスタンスにモジュールがデプロイされていない |
| 対処方法 | メインメニューからページに移動してください。メニュー項目自体が表示されていない場合、その機能はあなたのデプロイメントで有効になっていない可能性があります。管理者に連絡してください。 |
500 Internal Server Error
| 症状 | 一般的なサーバーエラーメッセージでアクションが失敗する |
| 原因 | バックエンドAPIで処理されない例外が発生 |
| 対処方法 | バックエンドコンテナのログ(docker logs opsee-fastapi)を確認してください。エラーが再現可能な場合は、それを引き起こす正確なアクションをメモし、ログエントリと相関できるようタイムスタンプとともに管理者に報告してください。 |
502 Bad Gateway / 503 Service Unavailable
| 症状 | アプリケーション全体に502または503エラーページが表示される |
| 原因 | バックエンドサービスまたはその依存関係(データベース、Keycloak)がダウンしているか、まだ起動していない |
| 対処方法 | サーバーでdocker psを実行して、どのコンテナが稼働しているか確認してください。停止しているコンテナはdocker compose up -dで再起動してください。データベースが問題の場合は、ディスク容量の枯渇や接続上限エラーを確認してください。 |
ネットワークエラー
「接続できません」/ ネットワークエラー
| 症状 | ブラウザコンソールでネットワークエラーによりAPI呼び出しが失敗し、HTTPステータスコードが返されない |
| 原因 | OpSeeバックエンドコンテナが稼働していないか、NGINXリバースプロキシがそれに到達できない |
| 対処方法 | Dockerコンテナが稼働中であることを確認してください: docker ps。バックエンドコンテナが終了している場合は、docker logs opsee-fastapiでログを確認してください。docker compose up -dで再起動してください。 |
フォーム検証エラー
必須フィールド / 不正な形式
| 症状 | フォームが送信を拒否し、フィールドが赤くハイライトされる |
| 原因 | 必須フィールドが空、値が予期される形式に一致しない(例: 日付フィールドにテキストが含まれる)、または入力が最大長を超えている |
| 対処方法 | ハイライトされたすべてのフィールドに入力してください。各フィールドの下に表示される形式のヒントに注意してください。 |
重複エントリ
| 症状 | フォームは送信されるが、「既に存在します」や「重複キー」のようなエラーを返す |
| 原因 | 同じ一意識別子(名前、コードなど)を持つレコードがデータベースに既に存在する |
| 対処方法 | 一意フィールドに別の値を使用するか、新しいレコードを作成する代わりに既存のレコードを編集してください。 |