<![CDATA[LT-133: Staging 环境 Web API 忽略 API_VERSION_FOLDER]]>我要修改一个功能：staging阶段发布的web api，要忽略API_VERSION_FOLDER
KEY是LT-133
目前的这个web api，特指发布到IIS的基于.NET Framework 4.8的web api项目。

]]>https://talk.loda.net/topic/57/lt-133-staging-环境-web-api-忽略-api_version_folderRSS for NodeFri, 17 Apr 2026 08:32:59 GMTWed, 21 Jan 2026 17:45:28 GMT60<![CDATA[Reply to LT-133: Staging 环境 Web API 忽略 API_VERSION_FOLDER on Wed, 21 Jan 2026 18:25:39 GMT]]>我这个对话其实很简洁，因为我的工作区，设置了“Rule”如图：

图片.png

]]>https://talk.loda.net/post/110https://talk.loda.net/post/110Wed, 21 Jan 2026 18:25:39 GMT<![CDATA[Reply to LT-133: Staging 环境 Web API 忽略 API_VERSION_FOLDER on Wed, 21 Jan 2026 18:04:43 GMT]]>图片.png

]]>https://talk.loda.net/post/109https://talk.loda.net/post/109Wed, 21 Jan 2026 18:04:43 GMT<![CDATA[Reply to LT-133: Staging 环境 Web API 忽略 API_VERSION_FOLDER on Wed, 21 Jan 2026 18:03:14 GMT]]>从控制台输出看来，staging阶段的发布，忽略了API_VERSION_FOLDER：

图片.png

]]>https://talk.loda.net/post/108https://talk.loda.net/post/108Wed, 21 Jan 2026 18:03:14 GMT<![CDATA[Reply to LT-133: Staging 环境 Web API 忽略 API_VERSION_FOLDER on Wed, 21 Jan 2026 17:50:12 GMT]]>图片.png

]]>https://talk.loda.net/post/107https://talk.loda.net/post/107Wed, 21 Jan 2026 17:50:12 GMT<![CDATA[Reply to LT-133: Staging 环境 Web API 忽略 API_VERSION_FOLDER on Wed, 21 Jan 2026 17:45:53 GMT]]>不急，请为我补充文档后一起签入。

]]>https://talk.loda.net/post/106https://talk.loda.net/post/106Wed, 21 Jan 2026 17:45:53 GMT<![CDATA[Reply to LT-133: Staging 环境 Web API 忽略 API_VERSION_FOLDER on Wed, 21 Jan 2026 17:45:41 GMT]]>我来搜索staging阶段发布web api相关的配置，了解API_VERSION_FOLDER的使用情况。

让我先读取更多相关文件，了解API_VERSION_FOLDER的完整使用逻辑。

理解了。需要让staging环境的web api部署也忽略API_VERSION_FOLDER。

关键代码在upload-web.sh第473-480行：

# 环境特定配置覆盖
# 强制覆盖开发和测试环境的API版本文件夹设置
DEPLOY_ENV="${DEPLOY_ENV_NAME:-$CURRENT_ENV}"
if [[ "$DEPLOY_ENV" == "development" ]] || [[ "$DEPLOY_ENV" == "dev" ]] || [[ "$DEPLOY_ENV" == "test" ]]; then
    if [[ "$API_VERSION_FOLDER" != "/" ]]; then
        info "🔧 检测到开发/测试环境，强制覆盖 API_VERSION_FOLDER: '$API_VERSION_FOLDER' -> '/'"
        export API_VERSION_FOLDER="/"
    fi
fi

目前只覆盖dev/development/test，需要加入staging。

确认需求：staging环境的web api是否需要额外判断TARGET_FRAMEWORK（只针对.NET Framework 4.8），还是所有staging的web api都忽略API_VERSION_FOLDER？

修改完成。现在更新脚本版本信息：

修改完成。

修改总结

文件：@X:\gitlab\loda.online\server\gitlab\gitlab-runner\gitlab-runner-docker\srv\scripts\upload-web.sh

改动：

  1. 在环境特定配置覆盖逻辑中，将staging加入条件判断
  2. 现在dev/development/test/staging环境都会强制将API_VERSION_FOLDER覆盖为/
  3. 更新脚本版本号为v2025.01.22-01:20

Git 提交命令

cd "X:\gitlab\loda.online\server\gitlab\gitlab-runner\gitlab-runner-docker"
git add srv/scripts/upload-web.sh
git commit -m "LT-133: staging环境web api忽略API_VERSION_FOLDER"
git push
]]>https://talk.loda.net/post/105https://talk.loda.net/post/105Wed, 21 Jan 2026 17:45:41 GMT