启动调试器导致VS Code开发容器崩溃求助

数月前在VS Code开发容器中配置了PyTorch，运行状态极佳，甚至能在程序运行时显示窗口——未明确配置Docker容器的GUI权限。环境为Windows搭配WSL（Arch发行版），Docker运行在WSL内部（非Docker Desktop的WSL后端）。

几周前开始，从VS Code启动调试器或尝试显示窗口时，容器会崩溃。VS Code仅显示“正在连接到远程”，Docker显示容器已停止，且Docker及容器日志中均无错误信息。

其他功能均正常：GPU可正常使用，无性能问题，开放端口可从Windows端访问（如tensorboard）。

猜测问题源于某次更新，因为其他配置未发生变化，但不知从何入手排查。

配置文件 #

Dockerfile #

FROM nvidia/cuda:12.3.1-runtime-ubuntu22.04

# Set environment variables
ENV DEBIAN_FRONTEND=noninteractive
ENV LANG C.UTF-8
ENV LC_ALL C.UTF-8

# Install system dependencies
RUN apt-get update && \
    apt-get install -y \
        build-essential \
        git \
        curl \
        ca-certificates \
        wget \
        python3-pip \
        python3-dev \
        python3-opencv \
        libglib2.0-0

RUN update-ca-certificates

# Upgrade pip
RUN python3 -m pip install --upgrade pip

ARG USERNAME=vscode
ARG USER_UID=1000
ARG USER_GID=$USER_UID

# Non-root user
RUN groupadd --gid $USER_GID $USERNAME \
    && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
    && mkdir -p /home/$USERNAME/.vscode-server /home/$USERNAME/.vscode-server-insiders \
    && chown ${USER_UID}:${USER_GID} /home/$USERNAME/.vscode-server* \
    && apt-get install -y sudo \
    && echo $USERNAME ALL=(root) NOPASSWD:ALL > /etc/sudoers.d/$USERNAME \
    && usermod -a -G audio,video $USERNAME \
    && chmod 0440 /etc/sudoers.d/$USERNAME \
    # Clean up
    && apt-get autoremove -y \
    && apt-get clean -y \
    && rm -rf /var/lib/apt/lists/*

# Set user
USER $USERNAME
ENV HOME /home/$USERNAME

RUN echo 'alias tensorboard="python3 -m tensorboard.main"' >> ~/.bashrc
RUN echo 'alias python="python3"' >> ~/.bashrc

devcontainer.json #

{
    "name": "Torch-minigrid",

    "runArgs": [
        "--gpus=all",
        "--ipc=host",
        "--shm-size=512m",
        "--network=host"
    ],
    
    "build": {
        "dockerfile": "./Dockerfile"
    },
    
    "forwardPorts": [6006],
    
    "customizations": {
        "vscode": {
            "settings": {
                "terminal.integrated.defaultProfile.linux": "bash",
                "terminal.integrated.profiles.linux": {
                    "bash": {
                        "path": "/bin/bash"
                    }
                }
            },
            
            "extensions": [
                "ms-azuretools.vscode-docker",
                "github.copilot",
                "eamodio.gitlens",
                "ms-python.python",
                "ms-python.vscode-pylance",
                "ms-python.isort",
                "christian-kohler.path-intellisense"
            ]
        }
    },
    
    "postCreateCommand": "pip install -r requirements.txt",

    "shutdownAction": "stopContainer"
}

1. 补全GUI权限配置 #

之前能显示窗口可能是--network=host的偶然兼容，更新后规则变化导致失效，需手动配置X11转发：

• 在WSL Arch中安装xorg-xauth：sudo pacman -S xorg-xauth
• 在devcontainer.json的runArgs中添加：

  "-e", "DISPLAY=${env:DISPLAY}",
  "-v", "/tmp/.X11-unix:/tmp/.X11-unix",
  "-v", "${env:HOME}/.Xauthority:/home/vscode/.Xauthority:ro"
  

• Windows端运行X服务器（如VcXsrv、X410），启动时勾选“Disable access control”

2. 调试器兼容性排查 #

• 回滚VS Code Python扩展：近期扩展更新可能引入问题，尝试切换到之前能正常运行的版本
• 简化调试配置：创建基础launch.json测试，排除复杂配置干扰：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: Current File",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "console": "integratedTerminal"
          }
      ]
  }
  

3. 捕获容器崩溃细节 #

• 启动容器时添加--init参数：在devcontainer.json的runArgs中加入"--init"，用init进程管理容器内进程，可能捕获崩溃信号
• 手动启动容器排查：在WSL终端执行：

  docker run --gpus=all --ipc=host --shm-size=512m --network=host -it --rm your-image-name bash
  

  手动运行程序或启动调试，观察终端输出的错误信息

4. 回滚更新类操作 #

• 回滚WSL内核：执行wsl --update --rollback，回到问题出现前的内核版本
• 固定依赖版本：将requirements.txt中PyTorch、opencv-python等GUI相关库的版本锁定到之前正常运行的版本

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