トラブルシューティング
まずこれをしてください
どんな問題でも、サイトルートの runtime.log を読んでください。
runtime/log/ の中ではなく、ルート直下の runtime.log です。ほぼすべての問題の本当の原因がそこに書かれています。
DEBUG=falseの場合、捕捉されなかった例外は 404 ページとして描画され HTTP 500 で返されます。画面には手がかりが何も出ません。本当の原因はruntime.logにしかありません。
インストールとアクセス
トップページだけ開けて、リンクを踏むとすべて 404 URL 書き換えが未設定です。書き換えルールを参照してください。
真っ白／500 多くは bcmath 拡張の不足です。金額計算がすべてこれに依存しており、無いと致命的エラーになります。インストール方法の選択を参照。
インストーラが「ディレクトリに書き込めません」と言うconfig、runtime、kernel/Install、assets/cache が書き込み可能である必要があります。宝塔ならサイトディレクトリの所有者を www にしてください。
Docker コンテナは動いているのにブラウザで開けない ポートマッピングが逆です。-p 8080:80 の左がホスト側、右は常に 80 です。クラウドサーバーではセキュリティグループの開放も必要です。
Docker のアップグレード後にデータが消えた-v acg_data:/data が指定されていませんでした。Docker でインストール参照。
移行後
新サーバーで動かない場合は、この順で確認します。
config/database.phpが旧サーバーの情報のままになっていないか- 旧サイトが Redis にセッションを保存していたなら、新サーバーにも導入するか、PHP のセッション保存先をファイルに戻す
- PHP 拡張がすべて入っているか（特に
bcmath） - ディレクトリ権限と URL 書き換えは、どちらも設定し直しが必要です
アップグレードと移行も参照してください。
注文と決済
購入者が支払ったのに何も届かない
- 商品注文を注文番号か連絡先で検索し、注文が存在するか確認
- 状態を確認。「未入金」のままなら決済コールバックが届いていません
- コールバックが届かない主な原因は、事業者側のコールバック URL の誤り、または CDN のファイアウォールによる遮断です
- CDN が原因ならカスタム決済コールバックドメインで回避します（サイト設定参照）
在庫はあるのにストアフロントでは売り切れ表示 商品に種別や SKU がある場合、在庫は組み合わせごとに計算されます。合計は多くても、その組み合わせのカードが無ければ売り切れです。カードがロックされている可能性もあります（カード在庫管理参照）。
年額を選んだのに月額のカードが届いた カード取り込み時の種別が違っていました。
商品が 0 円と表示される 会員価格が未入力だと、ログインユーザーは無料で持って行ける場合があります。両方の価格を入力してください（決済設定参照）。
サブストア
サブドメインが開けない 必要なのは 3 つで、どれか 1 つでも欠けると動きません。管理画面での本店ドメインと DNS-CNAME の設定、DNS 事業者での * ワイルドカードレコード、そしてサーバーでの *.ドメイン の紐付けです。最後のものが最も見落とされます。
独自ドメインが開けない サーバーに既定サイトが設定されていません（サブストア参照）。
ストア連携
店舗の追加に失敗する アドレス・加盟店 ID・キーの誤り、または相手側で連携が無効になっています。
顧客の注文でエラーになり発送されない 上流での残高が尽きています。連携注文は上流店舗のあなたの残高から支払われます。
商品一覧が空で返る 相手の商品で「API 連携」が有効になっていません。
プラグインとテーマ
プラグインを入れたのに何も起きない汎用プラグインで有効化する必要があります。
新しいフックファイルを追加したのに発火しない フック登録表はコンパイル済みキャッシュです。プラグインを停止して再度有効化すると再構築されます。
テーマを変えたら表示が崩れた テンプレートキャッシュを消してください。runtime/view/compile の中身を削除します。
runtime/configは絶対に削除しないでください。 設定キャッシュであり、消すとサイトが壊れます。
質問するときのコツ
一言の説明だけで原因を言い当てられる人はいません。質問する前に次を用意してください。
runtime.logの内容 — エラー後にサイトルートにあります- 何をしたら起きたのか — 直前の操作
- スクリーンショット — 問題に関係するもの
これらを揃えるのが結局いちばん早い解決法です。一言で書いて誰かが助けてくれるのを待つこともできますが、時間の節約にはならず、やり取りが長引くだけです。
質問できる場所
- Telegram：https://t.me/mcyofficial