Visual Studio can hang for good when the project options reactor computes options for a document in F# Miscellaneous Files or for a script while the UI thread synchronously waits for those options. The reactor asks the UI thread for the caret, and the UI thread is blocked waiting for the reactor.
The caret lookup came with #18393, which gave GetProjectOptionsFromScript a caret so that a #r "nuget: …" line is not resolved while it is still being typed (#18231).
Repro steps
Caught once in the debugger, not reproduced on demand. The window is any synchronous UI-thread wait on project options for such a document while the reactor is busy with it. Here it was:
- A solution restored with an F# document tab whose project is not loaded, so the file opened in F# Miscellaneous Files, with breakpoints set in it.
- An extension's
QueryStatus asked the not-yet-loaded frame for its text view, which forced EnsureDocumentFrameLoaded.
- Showing the frame made the debugger validate the breakpoint locations on the UI thread.
Actual behavior
Project options reactor thread:
Microsoft.VisualStudio.Services.VsTask.InternalGetResult
Microsoft.VisualStudio.Shell.ServiceProvider.QueryService
Microsoft.VisualStudio.Shell.ServiceProvider.GetService
Extensions.Document.TryGetIVsTextView Common/Extensions.fs
Extensions.Document.TryGetTextViewAndCaretPos Common/Extensions.fs
FSharpProjectOptionsReactor.textViewAndCaret LanguageService/FSharpProjectOptionsManager.fs
FSharpProjectOptionsReactor.getProjectOptionsFromScript
… tryComputeOptionsBySingleScriptOrFile, started from the reactor's MailboxProcessor loop
UI thread:
Microsoft.VisualStudio.Threading.JoinableTaskFactory.WaitSynchronouslyCore
Microsoft.VisualStudio.Threading.JoinableTask.CompleteOnCurrentThread
AbstractLanguageService<FSharpPackage, FSharpLanguageService>.VsLanguageDebugInfo.ValidateBreakpointLocation
Microsoft.VisualStudio.Platform.WindowManagement.Rdt.NotifyOnBeforeShow
WindowFrame.NotifyFrameShowing / ShowInternal / Show / TryReplacePlaceholderView
WindowFrame.LoadDocumentFrameInternalAsync
WindowFrame.EnsureDocumentFrameLoaded / GetProperty
… an extension's IOleCommandTarget.QueryStatus asking for the active text view
ValidateBreakpointLocation goes through F# breakpoint resolution to the parse results and so to the reactor, which sits on the first stack. ServiceProvider.GlobalProvider.GetService called off the UI thread needs the UI thread, and so do the RDT, IVsTextManager.GetActiveView, IVsTextView.GetCaretPos and the IVsTextViewEvents connection point that follow it. The reactor is a MailboxProcessor, so its work is not joined to the JoinableTask the UI thread waits for, and JTF.Run never runs the request. Switching the reactor to the UI thread with SwitchToMainThreadAsync would hang the same way.
The document here was a plain .fs file, for which the caret is useless: ScriptClosure.resolveDependencyManagerSources is its only reader, and only scripts have #r "nuget: …" lines. The same path also subscribed to IVsTextViewEvents for every such .fs file and recomputed script options on every caret line change.
Expected behavior
The reactor never waits for the UI thread: the UI thread publishes the caret, the reactor reads it, and files that are not scripts do not look for it at all.
Related information
- Windows 11, Visual Studio 18 Insiders, experimental instance
- The code path is unchanged on
main
Visual Studio can hang for good when the project options reactor computes options for a document in F# Miscellaneous Files or for a script while the UI thread synchronously waits for those options. The reactor asks the UI thread for the caret, and the UI thread is blocked waiting for the reactor.
The caret lookup came with #18393, which gave
GetProjectOptionsFromScriptacaretso that a#r "nuget: …"line is not resolved while it is still being typed (#18231).Repro steps
Caught once in the debugger, not reproduced on demand. The window is any synchronous UI-thread wait on project options for such a document while the reactor is busy with it. Here it was:
QueryStatusasked the not-yet-loaded frame for its text view, which forcedEnsureDocumentFrameLoaded.Actual behavior
Project options reactor thread:
UI thread:
ValidateBreakpointLocationgoes through F# breakpoint resolution to the parse results and so to the reactor, which sits on the first stack.ServiceProvider.GlobalProvider.GetServicecalled off the UI thread needs the UI thread, and so do the RDT,IVsTextManager.GetActiveView,IVsTextView.GetCaretPosand theIVsTextViewEventsconnection point that follow it. The reactor is aMailboxProcessor, so its work is not joined to theJoinableTaskthe UI thread waits for, andJTF.Runnever runs the request. Switching the reactor to the UI thread withSwitchToMainThreadAsyncwould hang the same way.The document here was a plain
.fsfile, for which the caret is useless:ScriptClosure.resolveDependencyManagerSourcesis its only reader, and only scripts have#r "nuget: …"lines. The same path also subscribed toIVsTextViewEventsfor every such.fsfile and recomputed script options on every caret line change.Expected behavior
The reactor never waits for the UI thread: the UI thread publishes the caret, the reactor reads it, and files that are not scripts do not look for it at all.
Related information
main