This is an automated email from the ASF dual-hosted git repository.
wenchen pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/spark-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 667ac6a243 Document sbt build issues with IDEs (#653)
667ac6a243 is described below
commit 667ac6a243b04269b232789f617f8b512b832b98
Author: Tian Gao <[email protected]>
AuthorDate: Wed Dec 17 19:32:37 2025 -0800
Document sbt build issues with IDEs (#653)
* Document sbt build issues with IDEs
Added troubleshooting tips for using sbt with IDEs.
* Clarify sbt usage in IDEs section
* Revise cache clearing instructions in developer-tools.md
Updated instructions for clearing cache and artifacts.
* Update HTML file
---
developer-tools.md | 20 ++++++++++++++++++++
site/developer-tools.html | 18 ++++++++++++++++++
2 files changed, 38 insertions(+)
diff --git a/developer-tools.md b/developer-tools.md
index 633be7473e..bce821d8c6 100644
--- a/developer-tools.md
+++ b/developer-tools.md
@@ -494,6 +494,26 @@ in the Eclipse install directory. Increase the following
setting as needed:
256M
```
+<h4>IDE with sbt</h4>
+
+When you use IDEs like VSCode or Cursor and you build from terminal with `sbt`,
+a common issue you'll encounter is something like
+
+```
+java.lang.RuntimeException: Failed to find name hashes for
+```
+
+This is because multiple instances are trying to build the project
simultaneously. Normally
+the culprit is your Java/Scala plugin in your IDEs.
+
+In order to fix this, first you need to disable auto-build of your plugins.
Then you need to
+clear all the artifacts with `sbt clean`. You'll also need to clear cache in
+
+```
+~/.m2
+~/.ivy2/
+```
+
<a name="nightly-builds"></a>
<h3>Nightly builds</h3>
diff --git a/site/developer-tools.html b/site/developer-tools.html
index e17efe3105..fa874b50f3 100644
--- a/site/developer-tools.html
+++ b/site/developer-tools.html
@@ -628,6 +628,24 @@ in the Eclipse install directory. Increase the following
setting as needed:</p>
256M
</code></pre></div></div>
+<h4>IDE with sbt</h4>
+
+<p>When you use IDEs like VSCode or Cursor and you build from terminal with
<code class="language-plaintext highlighter-rouge">sbt</code>,
+a common issue you’ll encounter is something like</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>java.lang.RuntimeException: Failed to find name hashes
for
+</code></pre></div></div>
+
+<p>This is because multiple instances are trying to build the project
simultaneously. Normally
+the culprit is your Java/Scala plugin in your IDEs.</p>
+
+<p>In order to fix this, first you need to disable auto-build of your plugins.
Then you need to
+clear all the artifacts with <code class="language-plaintext
highlighter-rouge">sbt clean</code>. You’ll also need to clear cache
in</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>~/.m2
+~/.ivy2/
+</code></pre></div></div>
+
<p><a name="nightly-builds"></a></p>
<h3>Nightly builds</h3>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
