Unity 2021.1.18f1启动项目报错：路径含非法字符，无错误脚本提示

错误信息 #

Unhandled exception. System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.---> System.ArgumentException: Illegal characters in path. (Parameter 'path')at System.IO.Path.GetFullPath(String path)at System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize, FileOptions options)at System.IO.StreamReader.ValidateArgsAndOpenPath(String path, Encoding encoding, Int32 bufferSize)at System.IO.StreamReader..ctor(String path, Encoding encoding, Boolean detectEncodingFromByteOrderMarks)at System.IO.File.InternalReadAllText(String path, Encoding encoding)at System.IO.File.ReadAllText(String path)at ApiUpdater.MovedFromOptimizer.Program.Main(String[] args)--- End of inner exception stack trace ---at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor, Boolean wrapExceptions)at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)at System.Reflection.MethodBase.Invoke(Object obj, Object[] parameters)at Program.Main(String[] args)

问题分析 #

这个报错由Unity内置的ApiUpdater.MovedFromOptimizer工具触发，核心原因是文件路径中包含系统不允许的非法字符。由于此前项目可正常打开，说明问题源于近期的路径变更、新增文件/文件夹或导入的第三方内容。

解决步骤 #

• 检查项目根路径：确认项目所在文件夹路径是否包含? * : " < > |、中文全角符号等非法字符，将路径修改为仅含英文半角字母、数字、下划线或横线的合法格式。
• 排查近期新增内容：逐一核对最近添加的脚本、资源文件夹或第三方包，确认其名称/路径是否存在特殊字符，有则修改为合法名称。
• 清理Unity缓存：删除项目根目录下的Library、Temp、obj文件夹，重启Unity让编辑器重新生成缓存文件。
• 验证包兼容性：如果近期导入了新的Unity Package，临时移除该包后重启项目，排查是否为包内路径问题导致冲突。
• 重置ApiUpdater设置：进入Edit > Preferences > External Tools，找到ApiUpdater相关选项，先禁用再启用，重启Unity测试。

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