Unity WebGL项目构建失败求助：全新项目亦报错，重装换版本无效

问题详情 #

构建任意Unity项目到WebGL平台时均触发多个错误，已尝试重新安装Unity、更换版本、创建全新项目、修改Unity偏好设置，问题仍未解决。

错误日志 #

BuildFailedException: Incremental Player build failed!
UnityEditor.Modules.BeeBuildPostprocessor.PostProcess (UnityEditor.Modules.BuildPostProcessArgs args) (at <42a64fd733d9417da1ea3a757ad9a96d>:0)
UnityEditor.WebGL.WebGlBuildPostprocessor.PostProcess (UnityEditor.Modules.BuildPostProcessArgs args) (at /Users/bokken/build/output/unity/unity/PlatformDependent/WebGL/Extensions/Unity.WebGL.extensions/BuildPostprocessor.cs:179)
UnityEditor.Modules.DefaultBuildPostprocessor.PostProcess (UnityEditor.Modules.BuildPostProcessArgs args, UnityEditor.BuildProperties& outProperties) (at <42a64fd733d9417da1ea3a757ad9a96d>:0)
UnityEditor.PostprocessBuildPlayer.Postprocess (UnityEditor.BuildTargetGroup targetGroup, UnityEditor.BuildTarget target, System.Int32 subtarget, System.String installPath, System.String companyName, System.String productName, System.Int32 width, System.Int32 height, UnityEditor.BuildOptions options, UnityEditor.RuntimeClassRegistry usedClassRegistry, UnityEditor.Build.Reporting.BuildReport report) (at <42a64fd733d9417da1ea3a757ad9a96d>:0)
UnityEditor.BuildPlayerWindow:BuildPlayerAndRun()



UnityEditor.BuildPlayerWindow+BuildMethodException: 5 errors
  at UnityEditor.BuildPlayerWindow+DefaultBuildMethods.BuildPlayer (UnityEditor.BuildPlayerOptions options) [0x002da] in <42a64fd733d9417da1ea3a757ad9a96d>:0 
  at UnityEditor.BuildPlayerWindow.CallBuildMethods (System.Boolean askForBuildLocation, UnityEditor.BuildOptions defaultBuildOptions) [0x00080] in <42a64fd733d9417da1ea3a757ad9a96d>:0 
UnityEditor.BuildPlayerWindow:BuildPlayerAndRun ()


[Version and Build] Build failed! 00:00:27.5054735
UnityEngine.Debug:LogError (object)
Unity.Play.Publisher.Editor.PublisherBuildProcessor/<WaitUntilBuildFinishes>d__7:MoveNext () (at Library/PackageCache/com.unity.connect.share@4.2.3/Editor/PublisherBuildProcessor.cs:77)
Unity.EditorCoroutines.Editor.EditorCoroutine/YieldProcessor:MoveNext (System.Collections.IEnumerator) (at Library/PackageCache/com.unity.editorcoroutines@1.0.0/Editor/EditorCoroutine.cs:80)
Unity.EditorCoroutines.Editor.EditorCoroutine:ProcessIEnumeratorRecursive (System.Collections.IEnumerator) (at Library/PackageCache/com.unity.editorcoroutines@1.0.0/Editor/EditorCoroutine.cs:134)
Unity.EditorCoroutines.Editor.EditorCoroutine:MoveNext () (at Library/PackageCache/com.unity.editorcoroutines@1.0.0/Editor/EditorCoroutine.cs:115)
UnityEditor.EditorApplication:Internal_CallUpdateFunctions ()

解决方案 #

• 禁用增量构建：打开Build Settings窗口，取消WebGL平台Build Options中的Incremental GC和Incremental Build选项，重新构建。
• 清理Bee构建缓存：关闭Unity，删除项目根目录下的Library/Bee、Temp、Obj文件夹，重启项目后构建。
• 检查WebGL工具链：通过Unity Hub确认当前Unity版本已安装WebGL Build Support及对应Emscripten组件，缺失则重新安装。
• 修复包依赖：打开Package Manager，重新安装com.unity.connect.share包，或删除Library/PackageCache中相关包文件夹让Unity重新下载。
• 调整系统权限：将构建输出路径改为非系统盘，或以管理员身份运行Unity编辑器。
• 重置偏好设置：关闭Unity，删除对应系统的Unity偏好文件夹（Windows：C:\Users\<用户名>\AppData\Roaming\Unity；macOS：~/Library/Application Support/Unity），重启后重新配置并构建。

内容的提问来源于stack exchange，提问作者BILLY