Cloud Run部署Node.js服务执行bash命令报未终止引号字符串错误

问题描述 #

在GCP Cloud Run部署的Node.js API服务里，执行pwd这类简单命令完全正常，但执行freeze命令（无论是否带参数）都会触发如下错误：

/usr/bin/freeze: line 0: syntax error: unterminated quoted string

本地运行Node服务、本地构建的Docker镜像均无此问题，仅在Cloud Run部署后复现。相关代码与配置如下：

执行命令的核心代码 #

// 正常运行的代码
const command = `pwd`;
await execPromise(command);

// 报错代码（仅执行`freeze`也会触发相同错误）
const filePathAndName = "/tmp/<uuid>"
const command = `freeze ${filePathAndName}`;
await execPromise(command);

Dockerfile中安装freeze的配置 #

COPY /deps/freeze_0.2.2.apk freeze_0.2.2.apk
RUN apk add --allow-untrusted freeze_0.2.2.apk

execPromise函数实现 #

function execPromise(command: string): Promise<string> {
    return new Promise(function (resolve, reject) {
        childProcessExec(command, (error, stdout, stderr) => {
            if (stderr) {
                console.error(`stderr: ${stderr}`);
            }
            if (error) {
                console.error(`exec error: ${error}`);
                reject(error);
                return;
            }
            resolve(stdout.trim());
        });
    });
}

解决方案 #

1. 显式指定用bash执行命令 #

Cloud Run默认执行环境可能使用sh而非bash，而freeze脚本可能依赖bash语法特性。直接在命令前指定bash调用：

// 带参数的调用
const command = `bash -c 'freeze ${filePathAndName}'`;
// 无参数的调用
const command = `bash -c 'freeze'`;

2. 改用execFile避免shell解析问题 #

child_process.exec会通过shell解析命令字符串，容易出现转义或语法解析错误。换成execFile直接执行二进制文件，传递参数数组：

import { execFile } from 'child_process';

// 重写execPromise为支持数组参数的版本
function execPromise(command: string, args?: string[]): Promise<string> {
    return new Promise(function (resolve, reject) {
        execFile(command, args, (error, stdout, stderr) => {
            if (stderr) {
                console.error(`stderr: ${stderr}`);
            }
            if (error) {
                console.error(`exec error: ${error}`);
                reject(error);
                return;
            }
            resolve(stdout.trim());
        });
    });
}

// 调用方式
await execPromise('freeze', [filePathAndName]);

这种方式跳过shell直接执行，彻底避免解析层面的问题。

3. 修改freeze脚本的shebang行 #

检查/usr/bin/freeze的开头shebang，如果是#!/bin/sh，在Cloud Run的sh环境下可能触发语法错误。在Dockerfile中替换为bash：

RUN sed -i 's/#!\/bin\/sh/#!\/bin\/bash/' /usr/bin/freeze

验证步骤 #

1. 在Cloud Run中执行bash -c 'freeze --version'，确认命令能正常运行，排除环境差异问题；
2. 测试execFile的调用方式，验证参数传递是否正常。

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