fix(amazonq): Prevents Q UriError : Validate file URI and fallback to Path.toUri() for WSL (#5960)

Fix repeated UriError when Amazon Q starts with a WSL-backed workspace. We now validate the constructed file: URI and fallback to JDK’s Path.toUri() if the URI violates Rule (no authority while the path begins with //, maybe RFC 3986). This keeps legacy behavior where it’s safe, and prevents Q from rejecting the workspace folder URI

Author: Lee-WonJun

.changes/next-release/bugfix-e00dc253-3047-4309-a9ee-edc955db3327.json

@@ -0,0 +1,4 @@
+{
+  "type" : "bugfix",
+  "description" : "Fix UriError when project is on WSL or a UNC path"
+}

plugins/amazonq/shared/jetbrains-community/src/software/aws/toolkits/jetbrains/services/amazonq/lsp/util/LspEditorUtil.kt

@@ -47,13 +47,25 @@ object LspEditorUtil {
     private fun toUri(file: File): URI {
         try {
             // URI scheme specified by language server protocol
-            return URI("file", "", file.absoluteFile.toURI().path, null)
+            val uri = URI("file", "", file.absoluteFile.toURI().path, null)
+            val fallback = file.toPath().toAbsolutePath().normalize().toUri()
+            return if (uri.isCompliant()) uri else fallback
         } catch (e: URISyntaxException) {
             LOG.warn { "${e.localizedMessage}: $e" }
             return file.absoluteFile.toURI()
         }
     }
 
+    private fun URI.isCompliant(): Boolean {
+        if (!"file".equals(this.scheme, ignoreCase = true)) return true
+
+        val path = this.rawPath ?: this.path.orEmpty()
+        val noAuthority = this.authority.isNullOrEmpty()
+
+        // If the authority component is empty, the path cannot begin with two slash characters ("//")
+        return !(noAuthority && path.startsWith("//"))
+    }
+
     /**
      * Works but is divergent from [FocusAreaContextExtrator]
      */

plugins/amazonq/shared/jetbrains-community/tst/software/aws/toolkits/jetbrains/services/amazonq/lsp/util/FileUriUtilTest.kt

@@ -8,6 +8,8 @@ import io.mockk.every
 import io.mockk.mockk
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.condition.EnabledOnOs
+import org.junit.jupiter.api.condition.OS
 import org.junit.jupiter.api.extension.ExtendWith
 
 @ExtendWith(ApplicationExtension::class)
@@ -96,6 +98,24 @@ class FileUriUtilTest {
         }
     }
 
+    @Test
+    @EnabledOnOs(OS.WINDOWS)
+    fun `test wsl-like path`() {
+        val virtualFile = createMockVirtualFile("//wsl.localhost/Ubuntu/home/user/file.sh")
+        val result = LspEditorUtil.toUriString(virtualFile)
+        val expected = normalizeFileUri("file://wsl.localhost/Ubuntu/home/user/file.sh")
+        assertThat(result).isEqualTo(expected)
+    }
+
+    @Test
+    @EnabledOnOs(OS.WINDOWS)
+    fun `test UNC path`() {
+        val virtualFile = createMockVirtualFile("//server/share/path/to/file.txt")
+        val result = LspEditorUtil.toUriString(virtualFile)
+        val expected = normalizeFileUri("file://server/share/path/to/file.txt")
+        assertThat(result).isEqualTo(expected)
+    }
+
     @Test
     fun `test jar protocol conversion`() {
         val virtualFile = createMockVirtualFile(