使用Python设置线程cgroup配额时出现sh: echo: I/O错误的原因及解决方法

我之前也碰到过类似的问题，结合cgroup的内核行为，帮你拆解下原因和解决办法：

为什么会出现I/O错误？ #

最核心的原因是你执行的命令存在逻辑问题，再加上可能的路径/配置疏忽：

• 写入内容完全无效：你用echo > /sys/fs/cgroup/cpu//cpu.cfs_quota_us是往文件里写入空字符串，而cpu.cfs_quota_us这个文件只接受两种有效值：要么是正整数（代表允许的CPU时间微秒数，必须是cpu.cfs_period_us的整数倍，默认周期是100000微秒），要么是-1（表示取消CPU配额限制）。空内容不符合内核的格式校验，直接抛出I/O错误。
• 路径冗余斜杠（非致命但易误导）：路径里的//系统会自动转成单个/，本身不会导致错误，但如果没正确创建自定义cgroup子目录（比如直接在根cpu cgroup下操作，而非给目标线程单独建专属cgroup组），后续配置可能不符合预期。
• 配额与周期的依赖（次要）：虽然默认cpu.cfs_period_us是100000微秒，但如果之前把周期改成0或无效值，再设置配额也会触发错误，不过这种情况比较少见。

怎么解决这个问题？ #

按以下步骤修正即可：

1. 写入合法的配额值
   别再写入空内容，根据你的需求执行正确命令：

• 比如要限制线程使用20%的CPU（每100ms周期内允许用20ms）：

  echo 20000 > /sys/fs/cgroup/cpu/your_thread_cgroup/cpu.cfs_quota_us
  

• 如果要取消配额限制：

  echo -1 > /sys/fs/cgroup/cpu/your_thread_cgroup/cpu.cfs_quota_us
  

  注意：配额值必须是正整数且为周期值的整数倍，或者是-1，否则仍会报错。

2. 正确创建并绑定目标线程到cgroup
   建议不要直接修改根cpu cgroup的配置，给目标线程单独创建专属cgroup组：

# 创建自定义cgroup目录（需要root权限）
mkdir /sys/fs/cgroup/cpu/my_thread_cgroup
# 将目标TID加入这个cgroup
echo $TARGET_TID > /sys/fs/cgroup/cpu/my_thread_cgroup/tasks

之后再修改这个子目录下的配额和周期文件。

3. 验证配置是否生效
   设置完成后可以读取文件确认：

cat /sys/fs/cgroup/cpu/my_thread_cgroup/cpu.cfs_quota_us
cat /sys/fs/cgroup/cpu/my_thread_cgroup/cpu.cfs_period_us

如果返回你设置的数值，说明配置成功。

4. 权限问题兜底
   如果你不是以root用户执行，可能会碰到权限问题（虽然你的错误是I/O错误，但也可以排查），可以加sudo执行命令，或者给cgroup目录设置合适权限（不过非root用户操作cgroup有风险，建议优先用sudo）。

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