UE5像素流项目Docker镜像构建报错：目标路径不存在

我之前碰到过类似的问题，这种COPY路径错误通常是因为Unreal打包后的输出结构和你预期的不一致，甚至可能打包过程本身就失败了，根本没生成目标目录。咱们一步步来排查和解决：

1. 先确认打包是否成功，以及实际输出目录结构 #

首先得搞清楚RunUAT.sh执行后，到底在/tmp/project/dist下生成了什么。你可以在builder阶段的RUN命令末尾加上目录递归查看的命令，这样构建时就能直观看到结果：

RUN /home/ue4/UnrealEngine/Engine/Build/BatchFiles/RunUAT.sh BuildCookRun \
    -clientconfig=Development -serverconfig=Development \
    -project=/tmp/project/PixelStreamingDemo.uproject \
    -utf8output -nodebuginfo -allmaps -noP4 -cook -build -stage -prereqs -pak -archive \
    -archivedirectory=/tmp/project/dist \
    -platform=Linux \
    -Target=PixelStreamingDemo -nocompile -nocompileeditor \
    && ls -R /tmp/project/dist

重新构建镜像，查看这一步的输出——大概率你会发现，Unreal打包后不会直接把LinuxNoEditor放在dist根目录，而是会生成一个以Target名称命名的子目录（比如PixelStreamingDemo），LinuxNoEditor就藏在这个子目录里。

2. 调整COPY路径匹配实际输出 #

如果上面的输出显示实际路径是/tmp/project/dist/PixelStreamingDemo/LinuxNoEditor，那直接修改COPY步骤的路径即可：

COPY --from=builder --chown=ue4:ue4 /tmp/project/dist/PixelStreamingDemo/LinuxNoEditor ./

3. 检查RunUAT关键参数是否正确 #

还有几个参数可能导致打包失败或路径异常，得仔细核对：

• -Target=PixelStreamingDemo：这个名称必须和你的PixelStreamingDemo.uproject文件中定义的Target完全一致（大小写敏感）。可以打开uproject文件查看Targets节点确认名称。
• -platform=Linux：确保你的Unreal项目已经启用了Linux目标平台（默认可能没开启，需要在编辑器里先配置）。
• -archive参数：这个参数会把打包内容归档到指定目录，但Unreal默认会给归档内容加上Target和平台的层级结构，所以必须通过ls命令确认最终路径。

4. 确认项目文件是否正确复制到builder容器 #

有时候COPY命令可能没把uproject文件正确复制进去，导致RunUAT找不到项目而打包失败。可以在COPY之后加个查看命令验证：

COPY --chown=ue4:ue4 . /tmp/project
WORKDIR /tmp/project
RUN ls -la /tmp/project

确保PixelStreamingDemo.uproject确实出现在这个目录下，否则打包步骤会直接失败，自然不会生成LinuxNoEditor目录。

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