云学堂无法收发作业 版本：E0304P02

根据您提供的信息，关于云学堂无法收发作业的问题（版本E0304P02），可以结合相关文档进行排查。以下为可能的原因及处理建议：

1. 网络连通性问题
   若教师端发送作业失败、学生端接收作业失败，常见原因是教师端和学生端之间的网络异常。建议检查：

   • 教师端是否使用双网卡，若是可禁用其中一张网卡后重启教师端重试。
   • 通过Ping测试检查教师端和学生端的网络连通性。

2. 文件分发权限问题
   如果报错“对路径xxx的访问被拒绝。文件分发失败”，可能与素材空间的磁盘映射有关。处理办法：

   • 教师端取消素材空间的磁盘映射，网络驱动器选择素材空间对应的Z盘。
   • 在教师端软件安装目录下找到z.dat（记录了“素材空间”的映射信息），按照其中信息重新映射网络驱动器。
   • 映射后确认素材空间正常挂载，再尝试文件分发。

3. 作业空间挂载问题
   若学生端看不到作业空间，从排查流程看，需检查网络中是否打开了445端口、VMAgent进程是否正常、smbd服务是否运行等。若问题持续，可手动挂载学生空间/素材空间测试，或清理课程模板中的安全软件。

4. 资源释放问题（备选参考）
   若上课时提示“课程启动失败”或资源不足影响作业功能，可尝试将教室座位数暂时调小后重新上下课，释放之前未释放的资源，再恢复原座位数。此方法曾在同类场景中验证有效。

如果以上步骤均未能解决，建议联系新华三技术支持（400-810-0504），或参考具体日志进一步定位。

E0304P02 收发作业分为两种场景：①作业空间（S/T 网络映射盘，文件拷贝方式收发作业）；②教师端软件【发送文件】功能。手册查不到时按下面顺序逐层排查。

前置基础检查（先确认）

1. 确认教师端、学生端云桌面都正常登录上课，课堂连接状态正常，大屏监控、广播、学生演示等基础教学功能是否正常。

如果广播、监控也异常，优先解决课堂通信问题，作业功能依赖课堂通道。

2. 确认版本匹配：云学堂平台 E0304P02，镜像内部LearningSpace 客户端版本必须对应 E0304P02，客户端版本不一致会直接导致作业收发异常。
3. 服务器侧：登录云学堂后台，确认smb、class‑service相关容器 / 服务运行正常；服务器存储盘剩余空间充足，磁盘没有只读告警。

场景一：作业空间（S 盘 / T 盘网络共享盘）无法收发作业

现象：学生端看不到 S 盘（作业提交）、教师端看不到 T 盘（作业收取）；或者盘符出现红叉，可以打开盘但是无法写入提交作业。

1. Web 后台教室配置检查 教室管理 → 对应教室 → 设置 → 高级设置 ✅勾选自动挂载作业 / 素材网络磁盘；先取消勾选保存，再重新勾选保存，下课重新上课生效。

该选项修改后必须全部学生下课重进课程，修改才生效，热上课不生效。

2. 盘符冲突检查 检查学生 / 教师云桌面内部，是否已经占用 S、T 盘符；如果已经被其他磁盘占用，在 Web 高级设置修改作业盘、素材盘的盘符，避开已占用盘符。
3. 镜像内部 Guest‑Tool 检查 作业盘挂载依赖镜像内ls‑guest‑tool工具。

• 修改镜像并启动进入镜像；卸载旧 guest‑tool，重新安装对应 E0304P02 版本的 guest‑tool；关机发布镜像。

旧版本 guest‑tool 会出现挂载脚本执行失败，能看到盘符但是无法读写提交作业。

4. SMB 共享权限（服务器侧） 登录云学堂底层操作系统，检查作业共享目录权限；SMB 服务运行状态。

• 如服务异常，重启服务：systemctl restart smb nmb
• 确认共享目录权限，不能设置只读。

5. 云桌面内部安全软件干扰 镜像内杀毒软件、安全卫士拦截 SMB 网络磁盘读写；将 S/T 盘、作业共享目录加入杀毒白名单。
6. 验证手动挂载（定位根因） 在故障云桌面 cmd 执行，账号密码默认user/user，测试手动挂载：

• 手动挂载报错，根据报错代码排查网络 / SMB 权限；
• 手动挂载成功、自动挂载失败，问题在 guest‑tool 脚本。

场景二：教师端软件【发送文件】功能无法收发作业（不走 S/T 盘）

1. 网络与端口检查 教师‑学生云桌面之间 UDP/TCP 教学端口互通；防火墙、安全组不要拦截教学业务端口。

云学堂 LearningSpace 课堂通信、文件分发使用自定义端口，不要开启严格 ACL 拦截。 多网卡场景：教师端云桌面存在多块网卡，会造成课堂通信异常，禁用无关虚拟网卡，只保留业务网卡，重启教师端软件。

2. 课堂会话状态 全部下课，重新开启新课堂；旧异常会话缓存会导致文件分发功能失效。
3. 客户端进程状态 在云桌面任务管理器，确认LearningSpaceTeacher.exe、LearningSpaceStudent.exe进程正常，无崩溃重启。

特殊 E0304P02 版本已知坑

1. 服务器磁盘满、inode 耗尽：虽然 Web 还能打开，但是 SMB 作业共享无法写入，作业提交直接静默失败，无报错。登录底层检查磁盘使用率df -h、df -i。
2. 集群多节点部署：注意时间同步 NTP 必须严格一致，时间差过大，SMB 共享鉴权失败，作业无法写入。
3. 复制升级上来的环境：升级后旧的 smb 配置残留，需要重新生成作业共享配置。

收集日志，进一步定位（手册无法解决时，提交 400 需要）

1. 云学堂服务器：收集 class‑service、smb 服务日志。
2. 故障教师 / 学生云桌面：收集 LearningSpace 客户端日志；C:\Windows\Temp\NetUse.log（作业盘挂载日志）。
3. 复现操作：记录是全部教室故障，还是单教室；全部终端故障还是个别终端。

快速区分：新建一个全新测试教室，使用干净发布的标准镜像上课，测试收发作业。如果新教室正常，说明原有教室配置 / 镜像问题；新教室同样故障，说明服务器底层服务问题。