この記事の要点

NetBeans 起動時の代表的エラー: 「Java プラットフォームを構成できません」 → netbeans.conf の netbeans_jdkhome を JDK パスに修正 プロジェクトコンパイル失敗は JDK バージョン不一致 / Source Level / Maven 設定が原因の大半 Tomcat 連携エラーは サーバー登録不備 / Catalina ログの確認 / ポート競合 PHP プラグインが立ち上がらないときは php.exe パス / Xdebug 設定を確認 メモリ不足 (OutOfMemoryError) は netbeans.conf の -J-Xmx2g を増やす

NetBeans のエラーは netbeans.conf がほとんど

NetBeans (Apache NetBeans) で起こるトラブルは、ユーザー設定 (--userdir) / JDK パス / メモリ設定の 3 つに集約されます。まずは設定ファイルの場所を押さえましょう。

OS	netbeans.conf	ユーザー設定 (userdir)
Windows	C:\Program Files\NetBeans-XX\netbeans\etc\netbeans.conf	%APPDATA%\NetBeans\XX\
macOS	/Applications/NetBeans/NetBeans XX.app/Contents/Resources/NetBeans/netbeans/etc/netbeans.conf	~/Library/Application Support/NetBeans/XX/
Linux	/usr/local/netbeans-XX/etc/netbeans.conf	~/.netbeans/XX/

エラー1: Java プラットフォームを構成できません

起動時に「Cannot locate java installation in specified jdkhome」「JDK が見つかりません」と出るケースです。

原因

• netbeans.conf の netbeans_jdkhome が無効なパス
• JDK 自体が未インストール / 削除された
• 32 bit / 64 bit ミスマッチ

対処

# netbeans.conf を編集
netbeans_jdkhome="C:\Program Files\Java\jdk-21"     # Windows
netbeans_jdkhome="/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home"  # macOS
netbeans_jdkhome="/usr/lib/jvm/jdk-21"              # Linux

# JDK パス確認 (Windows)
where java
java -version

# 確認 (mac/Linux)
which java
/usr/libexec/java_home -V    # macOS で全 JDK 一覧

コマンドラインから一時的に指定

# Windows
netbeans64.exe --jdkhome "C:\Program Files\Java\jdk-21"

# Linux/macOS
netbeans --jdkhome /usr/lib/jvm/jdk-21

エラー2: プロジェクトのコンパイル失敗

「Source release X requires target release X」「class file has wrong version」等。

原因と対処

原因	対処
Source / Target Level 不整合	プロジェクト Properties → Sources → Source/Binary Format を JDK に合わせる
古い .class が残存	Clean and Build (Shift + F11)
Maven の Java Version	pom.xml の maven.compiler.source / target を修正
Gradle の sourceCompatibility	build.gradle を修正
JDK と Platform 設定の食い違い	Tools → Java Platforms → Default に正しい JDK を

エラー3: Tomcat 連携エラー

「Tomcat server failed to start」「ポートが既に使われています」等。

# ポート競合の確認 (Windows)
netstat -ano | findstr :8080
taskkill /PID  /F

# Linux/macOS
lsof -i :8080
kill -9 

# Catalina ログの場所
{TOMCAT_HOME}/logs/catalina.out
{TOMCAT_HOME}/logs/localhost.{date}.log

典型対処

• Services タブ → Servers で Tomcat を右クリック → Properties → Connection でポート変更
• Catalina の Username / Password が tomcat-users.xml と一致しているか確認
• JDK のバージョンが Tomcat のサポート範囲内か (例: Tomcat 10 は JDK 11+)
• CATALINA_OPTS でメモリ拡張: -Xmx1024m

エラー4: PHP プラグインが起動失敗

PHP プロジェクト作成時に「PHP インタープリターが見つかりません」と出る場合:

1. Tools → Options → PHP タブ
2. PHP 5 Interpreter に php.exe のフルパスを指定 (Windows: C:\xampp\php\php.exe)
3. Debugger タブで Xdebug 設定 (Port: 9000 or 9003, IDE Key: netbeans-xdebug)
4. php.ini に下記を追加

[XDebug]
zend_extension="C:\xampp\php\ext\php_xdebug.dll"
xdebug.mode=debug
xdebug.start_with_request=trigger
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=netbeans-xdebug

エラー5: メモリ不足 (OutOfMemoryError)

大規模プロジェクトを開くと「java.lang.OutOfMemoryError: Java heap space」が出ます。netbeans.conf の netbeans_default_options を編集します。

# netbeans.conf
netbeans_default_options="-J-Xms256m -J-Xmx2g -J-XX:MaxMetaspaceSize=512m -J-Dapple.laf.useScreenMenuBar=true -J-Dapple.awt.graphics.UseQuartz=true -J-Dsun.java2d.noddraw=true -J-Dsun.zip.disableMemoryMapping=true"

# ポイント:
#   -J-Xms256m   起動時メモリ
#   -J-Xmx2g     最大メモリ (2 GB に拡張)
#   -J-XX:MaxMetaspaceSize=512m   Metaspace

エラー6: Maven / Gradle ビルド失敗

症状	原因	対処
Maven が依存解決できない	プロキシ / settings.xml 不備	Tools → Options → Java → Maven で Settings File 指定
Gradle Sync 失敗	Java バージョン不一致	gradle.properties の org.gradle.java.home を確認
「dependencies download failed」	ローカルリポジトリ破損	~/.m2/repository/.../*.lastUpdated を削除
「JAVA_HOME is set to an invalid directory」	環境変数不正	システム環境変数の JAVA_HOME 修正

エラー7: 起動できない / 画面が真っ白

「IDE がそもそも立ち上がらない」「Welcome 画面が描画されない」場合は userdir をリセット するのが最速です。

# 別ディレクトリで起動 (設定を引き継がない)
netbeans64.exe --userdir "C:\temp\nb-clean"

# 既存 userdir をバックアップして空に
ren "%APPDATA%\NetBeans\21" "21.bak"

# Linux/macOS
mv ~/.netbeans/21 ~/.netbeans/21.bak

エラー8: プラグイン更新エラー

• Plugin Manager の Settings → Update Center URL が古い → 最新の https://netbeans.apache.org/nb/plugins/... に
• SSL エラー: JDK の cacerts が古い → 最新 JDK に更新
• 「Validation failed」 → ダウンロード破損。一度プラグインキャッシュ削除 → {userdir}/var/cache/

エラー9: 日本語が文字化け

# netbeans.conf に追加
netbeans_default_options="... -J-Dfile.encoding=UTF-8"

# プロジェクト Properties → Sources → Encoding を UTF-8 に
# Tools → Options → Editor → Default Encoding を UTF-8 に

FAQ

Q: 起動時に何度試しても落ちる
A: --userdir リセット + JDK パス確認 + cache ディレクトリ削除の順で確認。

Q: 設定をクラウドで同期したい
A: NetBeans 自身に同期機能はないが、%APPDATA%\NetBeans\XX\config を OneDrive / Dropbox に置く運用が一般的。

Q: Apache NetBeans 21 で動かないプラグインがある
A: 一部レガシープラグインは Java 11+ に対応していない。代替プラグインを探すか NetBeans 12.x にダウングレード。

関連項目

• netbeans.conf — メイン設定ファイル
• Apache NetBeans — 公式
• OutOfMemoryError — メモリ不足全般
• Maven / Gradle — ビルドツール連携