Jenkins执行FastAPI单元测试时sudo权限错误排查求助

1. 修正sudoers文件的语法错误 #

你直接用echo追加内容到/etc/sudoers时犯了两个关键错误：

• 使用了中文引号（“”），sudoers只识别英文双引号""
• 规则里存在多余空格（ALL= NOPASSWD中=后多了空格）

正确的做法是用visudo编辑（它会自动校验语法，避免破坏sudoers文件）：

visudo

在文件末尾添加单条正确规则即可，重复规则无意义：

jenkins ALL=(ALL) NOPASSWD: ALL

如果想最小化权限（更安全），可以仅授权需要的chown命令：

jenkins ALL=(ALL) NOPASSWD: /bin/chown -R jenkins:jenkins ./docs/unit-tests/htmlcoverage

2. 确认sudoers文件权限 #

/etc/sudoers必须是440权限，否则sudo会拒绝读取：

ls -l /etc/sudoers

若权限不符，执行：

chmod 440 /etc/sudoers

3. 验证jenkins用户的sudo权限 #

手动切换到jenkins用户，测试目标命令是否无需密码：

su - jenkins
sudo chown -R jenkins:jenkins ./docs/unit-tests/htmlcoverage

如果仍提示输密码，检查sudoers文件中是否有优先级更高的规则（比如用户组规则）覆盖了这条配置。

4. 检查Jenkins流水线的执行上下文 #

确保流水线确实以jenkins用户运行：

• 若Jenkins部署在Docker容器中，需在容器内配置sudoers，而非宿主机
• 检查流水线脚本中是否有切换用户的操作

5. 禁止直接echo修改sudoers #

永远不要用echo直接追加内容到/etc/sudoers，一旦语法错误会导致所有sudo命令失效，甚至无法切换root。推荐用tee安全追加：

echo 'jenkins ALL=(ALL) NOPASSWD: ALL' | sudo tee -a /etc/sudoers

完成以上步骤后，重启Jenkins服务，重新触发流水线测试即可。

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