Robot Framework测试中使用wget下载文件生成空文件的问题排查

问题背景 #

在Edge浏览器的Robot Framework测试中，因公司政策无法修改浏览器设置，改用wget实现网页文件下载，自定义关键字如下：

Download File  [Arguments]  ${COOKIE_NAME}  ${FILE_URL}  ${FILENAME}
   ${OUTPUT_DIR}=    Set Variable    output/
   ${COOKIE} =  Get Cookie  ${COOKIE_NAME}
   Log    name: ${COOKIE.name}, value: ${COOKIE.value}
   Run and Return RC  wget --cookies=on --header "Cookie: ${COOKIE.name}=${COOKIE.value}" -O ${OUTPUT_DIR}${/}${FILENAME} ${FILE_URL}

日志显示Cookie名称和值均正确，但输出目录仅生成空文件。

可能的原因及调整方案 #

1. Cookie参数格式与冲突问题 #

--cookies=on会让wget自动处理cookie，和手动指定的Cookie请求头可能冲突，建议关闭自动cookie处理；同时如果Cookie值包含特殊字符，用单引号包裹整个Header内容避免Shell解析错误：

Run and Return RC  wget --cookies=off --header 'Cookie: ${COOKIE.name}=${COOKIE.value}' -O ${OUTPUT_DIR}${/}${FILENAME} ${FILE_URL}

2. 缺少必要的模拟浏览器请求头 #

部分网站会校验User-Agent、Referer等头信息，缺少会返回空内容或拒绝请求，添加这些头模拟浏览器行为：

Run and Return RC  wget --cookies=off \
  --header 'Cookie: ${COOKIE.name}=${COOKIE.value}' \
  --header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36 Edg/114.0.1823.82' \
  --header 'Referer: ${FILE_URL}' \
  -O ${OUTPUT_DIR}${/}${FILENAME} ${FILE_URL}

3. 输出目录与路径问题 #

确保output/目录存在且有写入权限，提前创建目录避免路径错误：

Create Directory  ${OUTPUT_DIR}  # 目录不存在则自动创建

同时检查${OUTPUT_DIR}${/}${FILENAME}生成的路径是否正确，比如Windows下可直接用${OUTPUT_DIR}${FILENAME}，或者确认${/}是系统正确的路径分隔符。

4. 捕获wget执行的详细错误信息 #

Run and Return RC仅返回退出码，无法看到具体错误，改用命令捕获标准输出和错误输出：

${RESULT}=  Run  wget --cookies=off --header 'Cookie: ${COOKIE.name}=${COOKIE.value}' -O ${OUTPUT_DIR}${/}${FILENAME} ${FILE_URL}  return_stdout=True  return_stderr=True
Log  wget标准输出: ${RESULT.stdout}
Log  wget错误输出: ${RESULT.stderr}

通过错误输出可直接定位问题，比如403权限拒绝、Cookie过期、文件URL无效等。

5. Cookie完整性问题 #

部分网站需要多个Cookie才能正常访问，或Cookie需要domain、path等属性验证。可以在浏览器中查看该文件页面的所有Cookie，将必要的Cookie拼接后传入：

# 示例：拼接多个Cookie
${COOKIE_STRING}=  Set Variable  ${COOKIE1.name}=${COOKIE1.value}; ${COOKIE2.name}=${COOKIE2.value}
Run and Return RC  wget --cookies=off --header 'Cookie: ${COOKIE_STRING}' -O ${OUTPUT_DIR}${/}${FILENAME} ${FILE_URL}

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