Why You Must Upgrade to IntelliJ IDEA 2025.3.1 Now – Critical Fixes and Rollback Explained

JetBrains released IntelliJ IDEA 2025.3.1, a maintenance update that unusually rolls back the recently introduced Query File feature and resolves more than 200 reported problems.

SQL workflow rollback

The previous 2025.3 version tried to replace the long‑standing Query Console with Query File, but user feedback highlighted broken global data sources, disrupted habits, and difficulty switching projects. JetBrains acknowledged the mistake and restored the original Query Console without a patch.

What does this mean? In 2025.3.1 the familiar Query Console returns with its original behavior and workflow.

What if you already created a Query File?

Option 1: Delete it directly.

Option 2 (recommended) : Drag it into Scratches and Consoles | Database Consoles to convert it back to a console.

Windows + WSL “lifeline”

For developers using WSL with Gradle on Windows, the update addresses several pain points that often caused test failures, debugger timeouts, and source‑generation errors.

Test execution now works reliably.

Debugger connections no longer time out.

Source generation succeeds where it previously failed.

Gradle and Maven synchronization are more stable, especially for large, multi‑module projects that previously suffered mysterious sync failures and incorrect root‑project detection.

Spring ecosystem fixes

Debugger: Bean evaluation failures during multi‑context testing are resolved, and errors no longer appear before the application context loads.

Web development: Automatic generation of Request Mapping is fixed; mixed properties and yml configurations no longer cause API version mismatches.

Kotlin + MongoDB: Gutter icons, code completion, and JSON query assistance are restored.

Java daily development experience improvements

Debugger stability: Fixed Groovy Step Into issues and eliminated exceptions when calling List.isEmpty().

Reduced false positives: Spurious warnings for Optional.ofNullable() and AssertJ annotations are removed.

Completion enhancements: Auto‑completion after closing parentheses works again.

Terminal and frontend support

Terminal: Fixed path glitches, Backspace behavior, and tab‑dragging bugs that made the built‑in terminal unreliable.

Frontend: TypeScript upgraded to 5.9 with TSX generic false‑positive fixes; Vue now supports multiple script blocks and Nuxt path warnings are resolved.

Conclusion

Although only a week old, IntelliJ IDEA 2025.3.1 demonstrates JetBrains’ rapid response to community feedback, correcting aggressive changes from the previous release and polishing numerous experience details. If you are still on 2025.3, open Toolbox or use Help → Check for Updates and upgrade immediately.