EKS集群Camunda平台通过GitLab脚本部署WAR文件返回400错误

核心错误原因 #

脚本存在5个直接导致请求失败的问题：

1. 文件上传参数格式错误：curl用-F上传本地文件时，路径前必须加@前缀，你写的upload="./target/Alert.war"会让curl把路径字符串当成普通表单值提交，根本不会读取本地WAR包。从日志看请求总大小只有278字节，远小于正常WAR包体积，就能印证这一点，Camunda收不到部署资源自然返回400。
2. 手动添加重复的Content-Type头：使用-F提交表单时curl会自动生成带正确boundary分隔符的multipart/form-data请求头，你手动加了两次不带boundary的同名头，会导致服务端无法解析表单内容，这部分头必须删掉。
3. 认证信息未传入请求：你计算了Base64编码的账号密码，但根本没有在curl请求里加Authorization请求头，修复文件上传问题后大概率会返回401错误。
4. 命令拼接存在转义问题：把curl参数拼到字符串里用eval执行的写法很容易出现引号截断、参数解析错误，你定义CURL_OPTS时的双引号嵌套本身就有语法问题。
5. 错误参数屏蔽了关键报错信息：你加了--fail参数，curl遇到4xx错误会直接退出，不会打印Camunda返回的JSON错误详情，这也是多日无法定位问题的核心原因——连服务端具体报什么错都看不到。
   另外默认接口地址没有加http:///https://协议前缀，虽然当前日志能连上80端口，但存在地址解析异常的隐患。

排查步骤 #

1. 先确认GitLab CI执行到部署阶段时，./target/Alert.war文件确实存在，必须在部署步骤前执行Maven/Gradle打包步骤，避免找不到文件。
2. 调试阶段先去掉--fail参数，让curl完整打印服务端返回的响应体，Camunda的400响应会明确标注缺失的参数或错误原因，不需要靠猜定位问题。
3. 确认EKS上的Camunda服务、前置Ingress/API网关没有对请求体大小做过小的限制，避免后续上传大WAR包时被拦截。

修复后可用脚本 #

SCRIPT=`realpath $0`
SCRIPTPATH=`dirname $SCRIPT`

if [ -z "$CAMUNDA_DEPLOYMENT_ENDPOINT" ]; then
  # 补全协议头，开启TLS的话替换为https
  CAMUNDA_DEPLOYMENT_ENDPOINT="http://my_camunda_url/engine-rest/deployment/create"
fi
if [ -z "$CAMUNDA_DEPLOYMENT_NAME" ]; then 
  CAMUNDA_DEPLOYMENT_NAME="rest-deployment"
fi
if [ -z "$CREDENTIALS_USERNAME" ]; then
  echo "Error: Username not set, please set the CREDENTIALS_USERNAME env variable."
  exit 1;
fi
if [ -z "$CREDENTIALS_PASSWORD" ]; then
  echo "Error: Password not set, please set the CREDENTIALS_PASSWORD env variable."
  exit 1;
fi

WAR_PATH="./target/Alert.war"
# 提前校验WAR包存在
if [ ! -f "$WAR_PATH" ]; then
  echo "Error: WAR file not found at $WAR_PATH, please run package step first."
  exit 1
fi
echo "Deploying to $CAMUNDA_DEPLOYMENT_ENDPOINT"
echo "WAR file size: $(du -h $WAR_PATH | cut -f1)"

echo "------------------------------"
echo "Executing deployment request:"
echo "------------------------------"

# 直接执行curl，不使用eval拼接，去掉手动写的Content-Type头，补全认证，文件路径加@
response=$(curl --show-error -v \
  -F "upload=@${WAR_PATH}" \
  -F "deployment-name=${CAMUNDA_DEPLOYMENT_NAME}" \
  --url "$CAMUNDA_DEPLOYMENT_ENDPOINT" \
  # 直接用curl的-u参数传账号密码即可，不需要手动算base64
  -u "${CREDENTIALS_USERNAME}:${CREDENTIALS_PASSWORD}"
)

echo "------------------------------"
echo "Response:"
echo "$response"
echo "------------------------------"

# 简单校验部署结果
if echo "$response" | grep -q '"id"'; then
  echo "Deployment completed successfully"
  exit 0
else
  echo "Deployment failed"
  exit 1
fi

注意事项 #

• 永远不要在使用-F上传表单时手动指定multipart/form-data的Content-Type，curl自动生成的头才包含服务端解析必须的boundary值。
• curl上传本地文件的-F参数格式固定为字段名=@本地文件路径，漏写@不会触发任何本地报错，只会把字符串作为值提交，非常容易踩坑。
• 调试HTTP接口时不要一开始就加--fail参数，先拿到完整的响应内容再做错误处理。

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