The API never returned an error. HTTP 200, valid JSON, finish reason: STOP. The only thing missing was groundingMetadata. No warning, no deprecation notice, nothing.
I run PartsplanAI, a B2B electronic components marketplace. Grounding is not optional for us — we use it to verify part specs against real datasheets and prevent hallucination. Wrong capacitance values or voltage ratings from a language model aren't just embarrassing; they cause real problems for engineers downstream.
For approximately one month (late January through February 27), our AI features ran without any grounding. Every part recommendation, every spec search — generated purely from the model's pre-trained knowledge. The corrupted data accumulated in our database and was served to B2B customers. We had no idea.
On February 27, I noticed recommendations weren't matching real datasheets. What followed was 16 hours of debugging — 63 Git commits, 13 different approaches. I rewrote prompts, rebuilt the search pipeline, changed configurations, adjusted timeouts, switched between parallel and sequential calls. Nothing worked, because the problem was never in my code.
The fix: switch to gemini-2.5-flash. 20 minutes. Done.
The changelog entry for January 21 reads only: "gemini-flash-latest alias now points to gemini-3-flash-preview"
No mention of grounding regression. No compatibility warning.
There's also a second undocumented behavior: on gemini-2.5-flash, if you set responseMimeType: 'application/json' and googleSearch simultaneously, the search is silently ignored. No error, no docs, no warning.
GitHub Issue #384 (google-gemini/generative-ai-js) confirms the grounding issue was known in the community before the alias change was made.
The January 21 changelog was published the same week as the Gemini 2.0 Flash general availability announcement.
If you're using gemini-flash-latest with grounding, verify that groundingMetadata is actually present in your responses. You may have been affected since January 21.