FAQ¶
本部分将收集微信群与网络学堂中提问较多、有价值的问题。
9. 部署的前端在回放页面刷新会出现 Application error: client-side exception
这是 Next.js 的一个 bug，已在更新版本的 Next.js 被修复。由于此问题不影响小作业的完成与评分，你可以忽略此问题。
你可以使用 yarn add next 更新到新版本的 Next.js 来解决此问题。
8. 部署的前端在 /list 页面刷新会出现 403 Forbidden
这是由于代码模板中的 nginx 配置没有考虑周全。由于此问题不影响小作业的完成与评分，你可以忽略此问题。
要解决此问题，你可以将 nginx 配置中 try_files 一行改为 try_files $uri $uri.html $uri/index.html /index.html;。
7. 镜像构建过程或 CI/CD 流程无法正常执行 .sh 脚本
由于代码模板仓库中的 start.sh 与 test.sh 并没有设置执行权限，若你需要在 Docker 构建过程或 CI/CD 流程中执行这两个脚本，请为它们添加可执行权限或是使用 sh start.sh 与 sh test.sh。
6. 小作业部署后 CI/CD 阶段失败，提示“401: Unauthorized operation.Attach token.”
请检查项目变量设置中 DEPLOY_TOKEN 是否正确设置。没有设置此变量或提供的密钥错误都可能导致此结果。
5. 小作业部署后访问提示 502 Bad Gateway 或访问显示 nginx 默认界面
这可能是你没有正确设置变量导致 deployer 没有访问镜像的权限。请检查 REGISTRY_PWD 变量的权限是否为 read_registry (注意不是 read_repository)，并确认项目 CI/CD 中正确添加了变量，包括 main 分支是否被保护，以及复制粘贴 token 时是否出现错误，例如在结尾意外加入了空格等。若你无法确定是否正确设置了变量，请尝试重新生成 token 并重新设置变量。
对于后端小作业，若你是 Windows 用户，则还可能是 start.sh 的换行序列是 CRLF 导致的。由于 Docker 容器运行在 Linux 环境下，而 Linux 使用 LF 作为换行序列，这可能导致 start.sh 运行失败使得容器无法正常运行。你可以通过将换行序列从 CRLF 改为 LF 来解决此问题。
4. 前端小作业部署后访问提示 403 Forbidden
这可能是你没有正确地导出静态页面文件。请阅读小作业文档中提供的链接了解如何通过 Next.js 导出静态页面文件。你可以在本地先运行对应的指令观察生成的页面文件的位置。
3. 后端小作业部署后访问提示 500 Internal Server Error
这可能是你没有正确地配置 uWSGI。请阅读小作业文档中提供的链接了解如何通过 uWSGI 部署 Django 应用，并注意需要修改的参数可能不止一处。
2. CI/CD build 阶段失败
【问题】
1. 无权限拉取作业仓库
【问题】
C:\Users\[YourUserName]\.ssh\id_rsa.pub (Windows 系统) 或 ~/.ssh/id_rsa.pub (类 Unix 系统) 文件是否存在，若不存在请使用 ssh-keygen 命令生成。之后，将该文件的内容添加到 Tsinghua Git 中，你可以使用这个链接：https://git.tsinghua.edu.cn/-/profile/keys 快速导航到公钥添加面板。之后，请重新拉取小作业仓库。