使用VS Code Devcontainers扩展连接Docker容器时遇Error code 127错误

问题根源 #

报错中的symbol not found提示明确指向容器内的node二进制文件依赖的C++标准库符号缺失，原因是你使用的node:12.13.1-alpine基于Alpine Linux，默认采用musl C库，而VS Code Remote Server（容器内的code-server）依赖的是glibc，两者ABI不兼容，导致node无法正常启动，最终返回exit code 127。

解决方案 #

方案1：更换为基于Debian/Ubuntu的Node镜像（推荐） #

直接将Dockerfile的基础镜像替换为使用glibc的Node版本，比如Debian Buster分支，这类镜像原生兼容VS Code Remote Server，无需额外配置：

FROM node:12.13.1-buster as build-stage

RUN mkdir -p /usr/src/test

WORKDIR /usr/src/test

COPY . .

RUN npm install
RUN npm install @quasar/cli@1.2.0
RUN npm rebuild node-sass
RUN npx quasar build

EXPOSE 8080

CMD ["npx", "quasar", "dev"]

方案2：在Alpine镜像中添加glibc兼容层 #

如果必须保留Alpine镜像，需手动安装glibc兼容包（注意匹配Alpine版本对应的glibc版本）：

FROM node:12.13.1-alpine as build-stage

# 安装glibc兼容层
RUN apk add --no-cache wget
RUN wget -q -O /etc/apk/keys/sgerrand.rsa.pub https://alpine-pkgs.sgerrand.com/sgerrand.rsa.pub
RUN wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.34-r0/glibc-2.34-r0.apk
RUN apk add glibc-2.34-r0.apk

RUN mkdir -p /usr/src/test

WORKDIR /usr/src/test

COPY . .

RUN npm install
RUN npm install @quasar/cli@1.2.0
RUN npm rebuild node-sass
RUN npx quasar build

EXPOSE 8080

CMD ["npx", "quasar", "dev"]

补充：Dev Container配置优化 #

在项目根目录创建.devcontainer/devcontainer.json文件，明确指定容器服务和工作目录，避免自动构建冲突：

{
  "dockerComposeFile": "../docker-compose.yaml",
  "service": "test_frontend",
  "workspaceFolder": "/usr/src/test",
  "remoteUser": "root"
}

原始错误信息 #

[2433 ms] Start: Run in container: cat <<'EOF-/tmp/vscode-remote-containers-server-53e9f905-3100-4ebf-ad4b-88c2eb77280c.js' >/tmp/vscode-remote-containers-server-53e9f905-3100-4ebf-ad4b-88c2eb77280c.js_1688027205219
[2436 ms] 
[2436 ms] 
[2439 ms] Container server: Error relocating /root/.vscode-server/bin/695af097c7bd098fbf017ce3ac85e09bbc5dda06/node: _ZNSt7__cxx1119basic_ostringstreamIcSt11char_traitsIcESaIcEEC1Ev: symbol not found
Error relocating /root/.vscode-server/bin/695af097c7bd098fbf017ce3ac85e09bbc5dda06/node: _ZNSt19_Sp_make_shared_tag5_S_eqERKSt9type_info: symbol not found
[2439 ms] Container server: Error relocating /root/.vscode-server/bin/695af097c7bd098fbf017ce3ac85e09bbc5dda06/node: _ZNSt7__cxx1118basic_stringstreamIcSt11char_traitsIcESaIcEEC1Ev: symbol not found
[2474 ms] Error: stream ended with:0 but wanted:9
        at c (c:\Users\tuddan\.vscode\extensions\ms-vscode-remote.remote-containers-0.295.0\dist\extension\extension.js:24:101670)
        at c:\Users\tuddan\.vscode\extensions\ms-vscode-remote.remote-containers-0.295.0\dist\extension\extension.js:24:101851
        at s (c:\Users\tuddan\.vscode\extensions\ms-vscode-remote.remote-containers-0.295.0\dist\extension\extension.js:27:5371)
        at Socket.<anonymous> (c:\Users\tuddan\.vscode\extensions\ms-vscode-remote.remote-containers-0.295.0\dist\extension\extension.js:27:5541)
        at Socket.emit (node:events:525:35)
        at endReadableNT (node:internal/streams/readable:1358:12)
        at process.processTicksAndRejections (node:internal/process/task_queues:83:21)
[2474 ms] Start: Run in container: mkdir -p '/tmp/devcontainers-16d69df0-3d34-4e25-8a1d-926a0a2cc9bb1688027201709' && cat > '/tmp/devcontainers-16d69df0-3d34-4e25-8a1d-926a0a2cc9bb1688027201709/env-loginInteractiveShell.json' << 'envJSON'
[2476 ms] Container server terminated (code: 127, signal: null).
[2479 ms] 
[2479 ms] 
[2493 ms] Command failed: /root/.vscode-server/bin/695af097c7bd098fbf017ce3ac85e09bbc5dda06/bin/code-server --log debug --force-disable-user-env --server-data-dir /root/.vscode-server --use-host-proxy --telemetry-level all --accept-server-license-terms --host 127.0.0.1 --port 0 --connection-token-file /root/.vscode-server/data/Machine/.connection-token-695af097c7bd098fbf017ce3ac85e09bbc5dda06 --extensions-download-dir /root/.vscode-server/extensionsCache --start-server --disable-websocket-compression
[2494 ms] Error relocating /root/.vscode-server/bin/695af097c7bd098fbf017ce3ac85e09bbc5dda06/node: _ZNSt7__cxx1119basic_ostringstreamIcSt11char_traitsIcESaIcEEC1Ev: symbol not found
Error relocating /root/.vscode-server/bin/695af097c7bd098fbf017ce3ac85e09bbc5dda06/node: _ZNSt19_Sp_make_shared_tag5_S_eqERKSt9type_info: symbol not found
Error relocating /root/.vscode-server/bin/695af097c7bd098fbf017ce3ac85e09bbc5dda06/node: _ZNSt7__cxx1118basic_stringstreamIcSt11char_traitsIcESaIcEEC1Ev: symbol not found

原始配置文件 #

Dockerfile #

FROM node:12.13.1-alpine as build-stage

RUN mkdir -p /usr/src/test

WORKDIR /usr/src/test

COPY . .

RUN npm install
RUN npm install @quasar/cli@1.2.0
RUN npm rebuild node-sass
RUN npx quasar build

EXPOSE 8080

CMD ["npx", "quasar", "dev"]

docker-compose.yaml #

version: '3.8'

services:
  test_frontend:
    container_name: test_frontend
    build:
      context: .
      dockerfile: ./Dockerfile
    restart: always
    ports:
      - 5070:8080
    volumes:
      - .:/usr/src/test
    networks:
      - test_network
networks:
  test_network:
    driver: bridge

环境版本 #

• VS Code: 1.79.2
• Devcontainer扩展: 0.295.0
• Docker: 24.0.2, build cb74dfc

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