PHPStorm formatter error: runBlockingCancellable is forbidden in the Write Action

[swayok]

When formatter is enabled, PHPStorm throws this error:

java.lang.IllegalStateException: 'runBlockingCancellable' is forbidden in the Write Action because it may start a long-running computation. This can cause UI freezes.
Consider running this 'runBlockingCancellable' under a read action outside your Write Action'

And nothing happens.

PhpStorm 2025.3 Build #PS-253.28294.345

[xepozz]

Hi @swayok,
Could you please share full stack trace?

[swayok]

java.lang.IllegalStateException: 'runBlockingCancellable' is forbidden in the Write Action because it may start a long-running computation. This can cause UI freezes.
Consider running this 'runBlockingCancellable' under a read action outside your Write Action'
	at com.intellij.openapi.progress.CoroutinesKt.assertBackgroundThreadAndNoWriteAction(coroutines.kt:587)
	at com.intellij.openapi.progress.CoroutinesKt.runBlockingCancellable(coroutines.kt:133)
	at com.intellij.openapi.progress.CoroutinesKt.runBlockingMaybeCancellable(coroutines.kt:197)
	at com.intellij.docker.compose.cli.DockerComposeCliUtil.run(dockerComposeCliUtil.kt:185)
	at com.intellij.docker.compose.service.commands.ComposeServiceExecCmd.execute(ComposeServiceExecCmd.java:103)
	at com.intellij.docker.compose.service.commands.ComposeServiceExecCmd.execute(ComposeServiceExecCmd.java:42)
	at com.jetbrains.php.remote.docker.compose.PhpDockerComposeRemoteProcessRunner.startRemoteProcess(PhpDockerComposeRemoteProcessRunner.java:241)
	at com.jetbrains.php.remote.docker.compose.PhpDockerComposeRemoteProcessRunner.getRemoteProcess(PhpDockerComposeRemoteProcessRunner.java:196)
	at com.jetbrains.php.remote.PhpRemoteInterpreterManagerImpl.getRemoteProcessHandler(PhpRemoteInterpreterManagerImpl.java:176)
	at com.jetbrains.php.tools.quality.QualityToolReformatFile.getRemoteProcessHandler(QualityToolReformatFile.java:129)
	at com.jetbrains.php.tools.quality.QualityToolReformatFile.getProcessHandler(QualityToolReformatFile.java:186)
	at com.jetbrains.php.tools.quality.QualityToolReformatFile.getProcessHandler(QualityToolReformatFile.java:65)
	at com.jetbrains.php.tools.quality.QualityToolReformatFile.invoke(QualityToolReformatFile.java:49)
	at com.github.xepozz.mago.formatter.MagoExternalFormatter.format(MagoExternalFormatter.kt:35)
	at com.intellij.psi.codeStyle.ExternalFormatProcessor.formatRangeInFile(ExternalFormatProcessor.java:122)
	at com.intellij.psi.codeStyle.ExternalFormatProcessor.formatRangeInFile(ExternalFormatProcessor.java:129)
	at com.intellij.formatting.service.ExternalFormatProcessorAdapter.lambda$formatRanges$0(ExternalFormatProcessorAdapter.java:56)
	at com.intellij.psi.impl.source.codeStyle.CoreCodeStyleUtil.postProcessRanges(CoreCodeStyleUtil.java:115)
	at com.intellij.formatting.service.ExternalFormatProcessorAdapter.formatRanges(ExternalFormatProcessorAdapter.java:55)
	at com.intellij.formatting.service.FormattingServiceUtil.formatRanges(FormattingServiceUtil.java:117)
	at com.intellij.psi.impl.source.codeStyle.CodeStyleManagerImpl.reformatText(CodeStyleManagerImpl.java:164)
	at com.intellij.psi.impl.source.codeStyle.CodeStyleManagerImpl.reformatText(CodeStyleManagerImpl.java:90)
	at com.intellij.codeInsight.actions.ReformatCodeProcessor.doReformat(ReformatCodeProcessor.java:220)
	at com.intellij.codeInsight.actions.ReformatCodeProcessor.lambda$prepareTask$5(ReformatCodeProcessor.java:165)
	at com.intellij.psi.codeStyle.CodeStyleSettingsManager.lambda$runWithLocalSettings$0(CodeStyleSettingsManager.java:106)
	at com.intellij.psi.codeStyle.CodeStyleSettingsManager.computeWithLocalSettings(CodeStyleSettingsManager.java:121)
	at com.intellij.psi.codeStyle.CodeStyleSettingsManager.runWithLocalSettings(CodeStyleSettingsManager.java:105)
	at com.intellij.application.options.CodeStyle.runWithLocalSettings(CodeStyle.java:361)
	at com.intellij.codeInsight.actions.ReformatCodeProcessor.lambda$prepareTask$6(ReformatCodeProcessor.java:157)
	at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:317)
	at com.intellij.codeInsight.actions.AbstractLayoutCodeProcessorWriteInterceptor.runFileWrite(AbstractLayoutCodeProcessorWriteInterceptor.java:16)
	at com.intellij.codeInsight.actions.AbstractLayoutCodeProcessor$ProcessingTask.lambda$performFileProcessing$6(AbstractLayoutCodeProcessor.java:486)
	at com.intellij.openapi.command.WriteCommandAction$BuilderImpl.lambda$doRunWriteCommandAction$1(WriteCommandAction.java:147)
	at com.intellij.openapi.application.impl.AppImplKt$runnableUnitFunction$1.invoke(appImpl.kt:124)
	at com.intellij.openapi.application.impl.AppImplKt$runnableUnitFunction$1.invoke(appImpl.kt:124)
	at com.intellij.platform.locking.impl.NestedLocksThreadingSupport.runWriteAction(NestedLocksThreadingSupport.kt:999)
	at com.intellij.openapi.application.impl.ApplicationImpl.runWriteAction(ApplicationImpl.java:1130)
	at com.intellij.openapi.command.WriteCommandAction$BuilderImpl.lambda$doRunWriteCommandAction$2(WriteCommandAction.java:145)
	at com.intellij.openapi.command.impl.CoreCommandProcessor.lambda$executeCommand$2(CoreCommandProcessor.java:143)
	at com.intellij.openapi.application.impl.AppImplKt$rethrowCheckedExceptions$2.invoke(appImpl.kt:126)
	at com.intellij.platform.locking.impl.NestedLocksThreadingSupport.doRunWriteIntentReadAction(NestedLocksThreadingSupport.kt:737)
	at com.intellij.platform.locking.impl.NestedLocksThreadingSupport.runPreventiveWriteIntentReadAction(NestedLocksThreadingSupport.kt:711)
	at com.intellij.platform.locking.impl.NestedLocksThreadingSupport.runWriteIntentReadAction(NestedLocksThreadingSupport.kt:665)
	at com.intellij.openapi.application.impl.ApplicationImpl.runWriteIntentReadAction(ApplicationImpl.java:1185)
	at com.intellij.openapi.command.impl.CoreCommandProcessor.executeCommand(CoreCommandProcessor.java:139)
	at com.intellij.openapi.command.impl.CoreCommandProcessor.executeCommand(CoreCommandProcessor.java:89)
	at com.intellij.openapi.command.WriteCommandAction$BuilderImpl.doRunWriteCommandAction(WriteCommandAction.java:154)
	at com.intellij.openapi.command.WriteCommandAction$BuilderImpl.lambda$run$0(WriteCommandAction.java:125)
	at com.intellij.openapi.application.TransactionGuardImpl.runWithWritingAllowed(TransactionGuardImpl.java:239)
	at com.intellij.openapi.application.TransactionGuardImpl.access$100(TransactionGuardImpl.java:25)
	at com.intellij.openapi.application.TransactionGuardImpl$1.run(TransactionGuardImpl.java:201)
	at com.intellij.openapi.application.impl.ApplicationImpl$7.lambda$run$0(ApplicationImpl.java:605)
	at com.intellij.concurrency.ThreadContext.installThreadContext(threadContext.kt:305)
	at com.intellij.openapi.application.impl.ApplicationImpl$7.run(ApplicationImpl.java:600)
	at com.intellij.openapi.application.impl.AppImplKt.rethrowExceptions$lambda$1(appImpl.kt:83)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:167)
	at com.intellij.util.concurrency.ChildContext$runInChildContext$1.invoke(propagation.kt:167)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:173)
	at com.intellij.util.concurrency.ChildContext.runInChildContext(propagation.kt:167)
	at com.intellij.util.concurrency.ContextRunnable.lambda$run$0(ContextRunnable.java:26)
	at com.intellij.concurrency.ThreadContext.resetThreadContext(threadContext.kt:294)
	at com.intellij.util.concurrency.ContextRunnable.run(ContextRunnable.java:25)
	at com.intellij.openapi.application.impl.AppImplKt.rethrowExceptions$lambda$2(appImpl.kt:94)
	at com.intellij.openapi.application.impl.LaterInvocator$1.run(LaterInvocator.java:130)
	at com.intellij.openapi.application.impl.NonBlockingFlushQueue.runNextEvent$lambda$1$1$0(NonBlockingFlushQueue.kt:334)
	at com.intellij.openapi.progress.impl.CoreProgressManager.computePrioritized(CoreProgressManager.java:901)
	at com.intellij.openapi.application.impl.NonBlockingFlushQueue.runNextEvent$lambda$1$1(NonBlockingFlushQueue.kt:333)
	at com.intellij.concurrency.ThreadContext.resetThreadContext(threadContext.kt:294)
	at com.intellij.openapi.application.impl.NonBlockingFlushQueue.runNextEvent$lambda$1(NonBlockingFlushQueue.kt:330)
	at com.intellij.platform.locking.impl.NestedLocksThreadingSupport.tryRunWriteIntentReadAction(NestedLocksThreadingSupport.kt:690)
	at com.intellij.openapi.application.impl.NonBlockingFlushQueue.runNextEvent(NonBlockingFlushQueue.kt:326)
	at com.intellij.openapi.application.impl.NonBlockingFlushQueue.flushNow(NonBlockingFlushQueue.kt:305)
	at com.intellij.openapi.application.impl.NonBlockingFlushQueue.FLUSH_NOW$lambda$0(NonBlockingFlushQueue.kt:167)
	at java.desktop/java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:318)
	at java.desktop/java.awt.EventQueue.dispatchEventImpl(EventQueue.java:781)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:728)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:722)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:400)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:87)
	at java.desktop/java.awt.EventQueue.dispatchEvent(EventQueue.java:750)
	at com.intellij.ide.IdeEventQueue.defaultDispatchEvent(IdeEventQueue.kt:664)
	at com.intellij.ide.IdeEventQueue._dispatchEvent(IdeEventQueue.kt:517)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$0$0$0(IdeEventQueue.kt:333)
	at com.intellij.ide.IdeEventQueueKt.performActivity$lambda$1(IdeEventQueue.kt:1065)
	at com.intellij.openapi.application.TransactionGuardImpl.performActivity(TransactionGuardImpl.java:109)
	at com.intellij.ide.IdeEventQueueKt.performActivity(IdeEventQueue.kt:1065)
	at com.intellij.ide.IdeEventQueue.dispatchEvent$lambda$0(IdeEventQueue.kt:331)
	at com.intellij.ide.IdeEventQueue.dispatchEvent(IdeEventQueue.kt:371)
	at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:207)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:128)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:117)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:113)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:105)
	at java.desktop/java.awt.EventDispatchThread.run(EventDispatchThread.java:92)

[xepozz]

@swayok could you please check if the newest 2026.1.2 build solve your issue?

[swayok]

Updated. No errors now. But it is not working from inside IDE. Working ok from command line though. Maybe something wrong with my Mago config. Will try to tweak configs.

[swayok]

Yes, that was a config issue.
Maybe it will be a good idea to add a notice about this.

My structure is like this:

project-folder
   - .docker (Docker configs and data)
   - src (Laravel project root dir)
      - app
      - config
      - database
      - tests
      - vendor
   - mago.toml

Wrong mago.toml:

[source]
workspace = "src"
paths = ["app", "config", "database", "tests"]
includes = ["vendor"]
excludes = ["resources/**", "public/**", "storage/**"]

Correct mago.toml:

[source]
workspace = "."
paths = ["src/app",  "src/config", "src/database", "src/tests"]
includes = ["src/vendor"]
excludes = ["src/resources/**", "src/public/**", "src/storage/**"]

Workspace should point to the root folder for plugin to work correctly.

[xepozz]

When the plugin run Mago, it overrides workspace from the command line: --workspace=${project path}, so it shouldn't be a problem as for me

[xepozz]

e.g.

format options: --workspace=/Users/xepozz/IdeaProjects/j-plugins/mago-plugin/playground fmt /Users/xepozz/IdeaProjects/j-plugins/mago-plugin/playground/2.php
analyze options: --workspace=/Users/xepozz/IdeaProjects/j-plugins/mago-plugin/playground analyze /Users/xepozz/IdeaProjects/j-plugins/mago-plugin/playground/2.php --reporting-format=json

[xepozz]

As for the config itself, I can add an inspection, but the rules should be clarified

[swayok]

The problem was that Mago did not work at all until I changed paths, includes and excludes because they are relative to workspace.