はじめに

こんにちは、未経験からエンジニア転職を目指しているものです。
オンラインスクールで本格的に学習して7ヶ月目に入りました。
PHP,Laravelを学習しポートフォリオを作成中です。
Postモデルに紐づいているMapInfoモデルのリレーションに悪戦苦闘したため、解決までの内容を整理しました。

概要

Laravel Sailを使った開発環境で、Google Maps APIを利用して地図を描画しました。
新規投稿作成画面に無事、地図情報が反映されるようになりましたが、
PostモデルとMapInfoモデルが紐づいた事で、新たな問題が発生しました。

1. 　投稿した内容が、投稿一覧に反映されず、〇〇のエラーが発生
2.　 1.の解決後、投稿編集画面を作成したが、updateが機能しない

＊2.については別投稿で説明予定

投稿した内容が、投稿一覧に反映されず、エラーが発生

ディレクトリ構成としては下記になります

post.blade.php : 新規投稿画面
index.blade.php :投稿一覧画面

処理の流れは下記になります。

post.blade.phpでform内容を投稿　
PostControllerのstoreメソッドが機能
データベースに保存
PostControllerのindexメソッドが機能　
index.blade.phpへ遷移し正しく表示される

しかし、投稿ボタンをクリックしたら添付のエラーが発生してしまいました。

原因の特定に向けた検証 part1

データベースには確かに投稿の内容が保存されていることを確認
PgAdminのクエリツールで以下を実施し確認

SELECT * FLOM posts;
SELECT * FLOM map_infos;

→このことから、PostControllerのstoreメソッドは機能している事を確認

原因の特定に向けた検証　psrt1

PostControllerのstoreメソッドが機能していないと仮説。

実行内容：
PostController.phpのindexメソッド内を return "Post Index is working."; に変更
結果：
ブラウザ上に Post Index is working　と表示された(下記の状態)
考察：
indexメソッドが機能していない訳ではない。

原因の特定に向けた検証　psrt2

検証ツールのネットワーク画面で302のエラーと失敗の表示を確認
失敗の表示は何度もされる

仮説：

indexメソッドがデータサーバーからアクセスするときに何かしらのエラーが起きている

→上記と、今回の事象が見られるようになったのが、PostモデルとMapInfoモデルのリレーションが成功しだしてからである事から、モデル部分に重点をおいて再検証を実施

原因解明：

protected $with = ['mapInfo'];をコメントアウトして無効化を実施
Eager Loading（関連データの自動読み込み）を無効にし、PostモデルをロードするときにMapInfoモデルのデータを自動的に取得させないように変更
上記実行後、無事にindex.blade.phpへ遷移し、投稿一覧画面が表示されるように。

原因の考察

Postモデルに関連するMapInfoデータが存在しない、もしくは正しく紐づいていない状態でEager Loadingを実行すると、Laravelが関連データを探しに行き、データベースに無駄な負荷がかかる。データが不完全な場合、サーバーがタイムアウトしたり、例外がスローされる可能性がある。
今回のケースでは、map_infosテーブルにある一部のデータがpost_idと正しく紐づいていない（nullの値がある）ことが原因で、Eager Loadingが期待通りに動作していなかったと考えられる。

まとめ

データベースでリレーションが絡むと、問題が複雑になる。
どの動きの過程で問題が起きているかを、一つずつ洗い出す事が大切である。

最後まで、ご視聴頂きありがとうございます。