Remix+Vite環境で`import.meta.glob`がファイルを見つけられない問題のデバッグログ
著者: ClaudeMix Team |
Remix+Viteでimport.meta.globを使うと、ローカルでは動くのにビルド時に「ファイルが見つからない」500エラーが出ることがある。原因は一つではなく、Viteの監視範囲・tsconfigのinclude・assetsInclude・パスのタイポが複合的に絡んでいた。
症状
- 使用スタック: Remix v2 / Vite /
.yamlファイル /import.meta.glob - 特定のページで500エラーが発生し、
import.meta.globが空のオブジェクトを返していた
Error: Spec file not found for feature: blog/posts (path: /app/specs/blog/posts-spec.yaml)// app/spec-loader/specLoader.server.ts
const specModules = import.meta.glob('/app/specs//*-spec.yaml', {
eager: true,
as: 'raw'
});
// specModules が空のため、yamlString が undefined となりエラー原因(4つの仮説を1つずつ検証)
単一の原因ではなく、4つの要因が複合的に絡み合っていた。1つ直しても再現するため「直ったと思ったらまた出た」が繰り返された。
- 【Viteの監視範囲外】:
spec.yamlがプロジェクトルート直下のdevelopディレクトリに配置されていた。RemixのViteプラグインはappディレクトリを重点的に監視するため、develop内のファイルは探索対象から漏れていた - 【TypeScriptのコンパイル対象外】:
tsconfig.jsonのincludeにappディレクトリ内の.yamlを対象とするパターンがなく、ファイルをapp配下に移動してもプロジェクトの一部として認識されなかった - 【Viteのアセット未認識】: Viteはデフォルトで
.yamlをインポート可能なアセットとして認識しない - 【パスのタイポ】: 上記3つを解決してもエラーが継続。ファイルは
app/specs/(複数形)に配置されていたが、import.meta.globのパスが/app/spec/(単数形)になっていた。この1文字の違いが最後の原因だった
解決策
mv develop/blog/posts-spec.yaml app/specs/blog/posts-spec.yaml// tsconfig.json
"include": [
"app//*",
+ "app//*.yaml"
]// vite.config.ts
build: {
+ assetsInclude: ['/*.yaml']
}// app/spec-loader/specLoader.server.ts
- const specModules = import.meta.glob('/app/spec//*-spec.yaml', {
+ const specModules = import.meta.glob('/app/specs//*-spec.yaml', {解決までの流れ
sequenceDiagram
participant User as 開発者
participant specLoader as specLoader.server.ts
participant Vite as Vite
participant RemixPlugin as Remix Plugin
participant tsconfig as tsconfig.json
User->>specLoader: loadSpec('blog/posts') を呼び出す
specLoader->>Vite: import.meta.glob('/app/specs//*-spec.yaml') を要求
Vite->>RemixPlugin: ファイル探索範囲を確認
RemixPlugin-->>Vite: 'app' ディレクトリ内を探索
Note over Vite: OK: ファイルは 'app' 内にある
Vite->>tsconfig: ファイルがプロジェクトに含まれるか確認
tsconfig-->>Vite: OK: "include": ["app//*.yaml"]
Note over Vite: OK: .yaml はプロジェクトの一部
Vite->>Vite: ファイルがアセットとして認識されるか確認
Note over Vite: OK: assetsInclude: ['/*.yaml']
Vite->>Vite: パス '/app/specs/...' に基づきファイルを探索
Note over Vite: OK: ファイル 'app/specs/blog/posts-spec.yaml' を発見!
Vite-->>specLoader: specModules に検出したファイル情報を格納して返す
specLoader->>specLoader: yaml.load(yamlString) を実行し、パース成功
specLoader-->>User: パース済みのSpecオブジェクトを返す学び
import.meta.globのチェックリスト: ①パスパターンのタイポ確認 ②Viteの監視範囲内か ③tsconfigのincludeに含まれるか ④ViteのassetsIncludeに含まれるか- 単数形/複数形のような些細な違いが大きな問題を引き起こす。複数の原因が絡む場合は1つずつ仮説を立てて検証する
- 「ローカルは動くが本番で動かない」問題は形を変えて繰り返し出現する。CSSのパスエイリアスが解決されない問題も同じ文脈で発生し、より大きなスコープではCloudflare PagesのファイルシステムAPI非互換問題として現れた