mini-agentプロジェクト、AIサポートエージェントデモ用のFastAPIバックエンドでCIの失敗が発生しました。この失敗は、テストスイートがPostgreSQLのpgvector拡張機能に依存していたために起こりました。GitHub Actionsワークフローは、この必須の拡張機能が含まれていない汎用PostgreSQLイメージを誤って使用していました。その結果、ベクトル拡張機能を作成しようとした際にデータベース初期化ステップが失敗しました。テスト環境とアプリケーションの要件とのこの不一致により、ワークフローはテスト実行フェーズで停止しました。修正は、GitHub Actions構成でPostgreSQLサービスイメージを変更することでした。更新されたイメージ、pgvector/pgvector:0.8.6-pg17は、必要なpgvector拡張機能を具体的に含んでいます。この1行の変更により、CIのデータベースサービスがアプリケーションの機能と一致するようになりました。この変更後、CIワークフローは正常に完了し、信頼性の高い統合テストが回復しました。学んだ教訓は、データベース拡張機能をCIの明示的な実行時依存関係として扱うことを強調しています。