记录项目从旧版本升级到 Unity 2022 过程中遇到的几个典型问题及解决方案。

问题一：Package Manager 只有 Remove 按钮，无法下载 URP

现象：升级 Unity 版本后，打开 Package Manager，URP 包只显示 Remove，点击后也无法重新下载安装。

原因：原项目对 URP 进行过源码修改，升级后残留了本地嵌入式包目录：

{项目根目录}/Packages/com.unity.render-pipelines.universal@xx.x.x

解决方案：

1. 删除 Packages/ 目录下的 com.unity.render-pipelines.universal@xx.x.x 文件夹
2. 从 Library/PackageCache/ 目录中找到对应版本的 URP 文件夹，复制到 Packages/ 目录下
3. 将复制过来的文件夹名末尾的 @xx.x.x 版本后缀删除

这样插件就恢复为本地源码模式，可以正常编辑修改。

问题二：Android 出包运行黑屏，URP NullReferenceException

现象：升级后打出 APK，运行时黑屏，Logcat 报错：

Non-fatal Exception: java.lang.Exception: NullReferenceException : Object reference not set to an instance of an object.
at UnityEngine.Rendering.Universal.UniversalRenderPipeline.SetupPerFrameShaderConstants(...)
at UnityEngine.Rendering.Universal.UniversalRenderPipeline.Render(...)
at UnityEngine.Rendering.RenderPipelineManager.DoRenderLoop_Internal(...)

原因：Unity 2022 的 URP 在初始化 Blue Noise Texture 时存在空引用问题。

参考讨论：Unity Forum - Null reference in URP’s SetupPerFrameShaderConstants

解决方案：

1. 在 Project 窗口中找到 UniversalRenderPipelineAsset.asset
2. 在 Inspector 中取消勾选 LOD Cross Fade
3. 确认下方的 LOD Cross Fade Dithering Type 变为灰色（不可选）即可

现象：升级后 Android 包内的 HTTP 请求全部失败，网络功能异常。

原因：Unity 2022 默认禁用了明文 HTTP 协议，仅允许 HTTPS。

解决方案：

打开 Edit → Project Settings → Player，切换到 Android 平台，找到：

Other Settings → Configuration → Allow downloads over HTTP

将选项改为允许即可。

建议：长期来看应将接口迁移到 HTTPS，HTTP 存在安全风险，此配置仅作临时过渡使用。