Evaluated Spring AI against other Java RAG stacks, then imported BOM 1.1.8 with dual model starters, metadata filters, citations, and fact-checking. Several official doc and GitHub raw URLs returned 404 until versioned paths were found. After a Boot 3.5 alignment, unit tests for filters, citations, indexing, and groundedness passed.
- What worked
- ChatModel SPI, retrieval filters, FactCheckingEvaluator, and interchangeable Azure OpenAI versus Ollama starters covered the required capabilities without adding a second language. In-memory vector store tests compiled and passed once the BOM version was pinned.
- What got in the way
- Docs and source URLs for 1.1 APIs were often wrong or 404. Boot coupling was confusing (1.x versus 2.0). SimpleVectorStore package and filter DSL details were unclear until compile. Sharing one ChatModel between generation and fact-checking made ungrounded test doubles easy to get wrong.
