企业官网建设流程全解析

1. VSCode 里 profile 没切过去，问题到底出在哪

你在resources下老老实实放了application-dev.yml、application-test.yml、application-prod.yml，application.yml里也写了spring.profiles.active: dev，结果在 VSCode 终端敲mvn spring-boot:run或者点launch.json里的启动项，日志里The following profiles are active: dev，datasource 还是连的 dev 库，logging.level也没变成 test 的 debug，${DB_URL:...}读的还是默认值，jasypt 的ENC(...)甚至被当成明文塞进连接串。

这个场景我太熟了。它不是 SpringBoot 坏了，而是「谁最后说了算」这件事没理清。SpringBoot 的 profile 激活来源有好几层：application.yml里的spring.profiles.active、launch.json的vmArgs、命令行-Dspring-boot.run.profiles、系统环境变量SPRING_PROFILES_ACTIVE、还有 IDE 自己的运行配置。优先级从低到高，后加载的覆盖先加载的。你在application.yml写active: dev，但launch.json里没配vmArgs，命令行也没带-Dspring-boot.run.profiles=test，那它当然老老实实按 dev 跑。

更隐蔽的是${DB_URL:jdbc:mysql://default:3306/db}这种写法。它读的是环境变量DB_URL，如果终端里没export DB_URL=...，就落到冒号后面的默认值。你以为切了 test profile 就会读application-test.yml里的 url，其实那行如果也写成${DB_URL:...}，照样被环境变量或默认值盖掉。jasypt 的ENC(...)同理，如果jasypt.encryptor.password没配或没生效，Spring 不会解密，直接把ENC(xxx)当字符串用，报错或者连不上。

所以排障的核心不是「再装个插件」，而是让一个能读你全部配置文件的工具，帮你把application.yml、application-{profile}.yml、launch.json、命令行参数、环境变量这五者的覆盖顺序对一遍。这篇就用 TaoToken 走 Codex，把这件事做成可复制的流程。

2. 前置：TaoToken 提供 Key 和 Base URL，不碰你的 yml

先把边界说清楚，避免误解。TaoToken 在这里只做一件事：给你一个模型通道的 Key 和 Base URL，让 Codex 能跑起来帮你核对配置。它不替 SpringBoot 读取 yml，不负责改 profile，也不会去动你的launch.json。真正干活的是走 TaoToken 通道的 Codex，它读你的工程文件、对比配置、告诉你哪一层覆盖了哪一层。

你需要准备的东西：

• 一个 TaoToken 账号，用来创建 Key。入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end
• 本机已装 VSCode、JDK、Maven，工程能正常mvn compile
• Codex 已经装好（VSCode 扩展或命令行版本都行）

创建 Key 的路径：打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，登录后进控制台，在 API Keys 页面新建一把 Key，复制出来。这个 Key 只显示一次，先存到安全的地方。控制台地址是 https://taotoken.net/console ，Key 管理页是 https://taotoken.net/api-keys ，后面要回来管理或吊销都从这里进。

Base URL 固定填https://taotoken.net/api，注意两点：不带/v1，不加任何 UTM 参数。很多人习惯性写成https://taotoken.net/api/v1，Codex 会拼出错误的请求路径，表现为 404 或模型列表拉不到。

3. 可复制配置：Codex 的 config.toml 怎么写

Codex 的配置文件在用户目录下的.codex/config.toml。Windows 是C:\Users\你的用户名\.codex\config.toml，macOS/Linux 是~/.codex/config.toml。没有就新建一个。

把模型通道指向 TaoToken，Key 填你刚创建的值：

# ~/.codex/config.toml model = "gpt-5-codex" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"

这里用env_key的方式，把 Key 放在环境变量里，比直接写进 toml 安全。然后在终端里导出：

# macOS / Linux export TAOTOKEN_API_KEY="你创建的Key" # Windows PowerShell $env:TAOTOKEN_API_KEY="你创建的Key"

如果你图省事，也可以直接在 toml 里写api_key = "你创建的Key"，但别把这份文件提交到 Git。

改完 config.toml 后，重启 VSCode 终端。注意是关掉当前终端窗口重新开一个，不是只关 Codex 面板。环境变量和 config.toml 都是进程启动时读的，旧终端里跑的还是老配置。重启后在终端敲codex，能正常对话就说明通道通了。

这一步做完，Codex 就有了读你工程的能力。接下来让它去核对配置。

4. 验证请求：让 Codex 对照四份文件排查 active profile

通道通了之后，在工程根目录启动 Codex，把下面这段排查指令丢给它。这段指令的关键是让它按「覆盖顺序」逐层比对，而不是泛泛地看。

我在 VSCode 里跑 SpringBoot，resources 下有 application.yml、 application-dev.yml、application-test.yml、application-prod.yml。 我用 mvn spring-boot:run -Dspring-boot.run.profiles=test 启动， 但日志里 Active Profile 还是 dev，datasource 连的是 dev 库。 请帮我做这几件事： 1. 读 application.yml，列出 spring.profiles.active 的值和所有 带 ${...:默认值} 的占位符。 2. 读 application-test.yml，列出 datasource.url、logging.level、 jasypt 相关配置。 3. 读 .vscode/launch.json，检查每个 configuration 的 vmArgs 和 args 里有没有 -Dspring.profiles.active 或 --spring.profiles.active。 4. 按 SpringBoot 的覆盖优先级，告诉我 test profile 为什么没生效， 是哪一层把它盖回去了。 5. 给出最小改动方案，只改必要的地方。

Codex 会逐个文件读，然后给你一份覆盖链分析。典型输出会指出：application.yml里active: dev是默认值，但launch.json的vmArgs里写了-Dspring.profiles.active=dev，命令行参数优先级高于配置文件，所以 test 被 dev 盖了。或者反过来，命令行带了 test，但launch.json里env段设了SPRING_PROFILES_ACTIVE=dev，环境变量又盖了命令行。

拿到分析后，按它给的最小改动改。比如把launch.json改成：

{ "configurations": [ { "type": "java", "name": "Launch with Test Profile", "request": "launch", "mainClass": "com.example.Application", "vmArgs": "-Dspring.profiles.active=test" } ] }

改完回 VSCode 终端验证：

mvn spring-boot:run -Dspring-boot.run.profiles=test

看启动日志里这两行：

The following 1 profile is active: "test" HikariPool-1 - Starting... HikariPool-1 - Added connection com.mysql.cj.jdbc.ConnectionImpl@...

如果Active Profile变成 test，datasource 连的是测试库地址，说明切过去了。再检查logging.level有没有按application-test.yml生效，以及ENC(...)有没有被正确解密——如果 jasypt 密码没配，这里会抛EncryptionOperationNotPossibleException，那就得回头补jasypt.encryptor.password。

跑通之后，你可以回 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 管理这把 Key，继续让 Codex 排查多环境配置的其他问题，比如 prod 的占位符、环境变量注入顺序。

5. 本篇常见错排查

5.1 改了 config.toml 但 Codex 还是走旧通道

九成是终端没重启。VSCode 的集成终端是独立进程，config.toml和环境变量在进程启动时读取。关掉终端面板重新开一个，或者按Ctrl+Shift+P执行Terminal: Kill All Terminals再开。还不行就检查env_key对应的环境变量名有没有拼错，TAOTOKEN_API_KEY和 toml 里写的是否一致。

5.2 Base URL 带了 /v1 导致 404

https://taotoken.net/api是正确写法。写成https://taotoken.net/api/v1会让 Codex 拼出/api/v1/chat/completions这类路径，服务端不认。检查 config.toml 里base_url那一行，末尾不要有斜杠，不要加/v1。

5.3 profile 切了但 datasource 没变

看application-test.yml里的 url 是不是也写成了${DB_URL:...}。如果是，环境变量DB_URL的优先级高于 yml 文件，终端里如果 export 过DB_URL，它会盖掉 test 文件里的值。排查方法：在终端echo $DB_URL（Windows 用echo $env:DB_URL），有值就 unset 掉再启动，或者把 test 文件里的占位符改成固定值。

5.4 ENC(...) 被当明文

jasypt 解密需要jasypt.encryptor.password。如果这个密码通过环境变量传入，确认启动时环境变量在。如果写在application.yml里，确认没有被 profile 文件覆盖成空。Codex 排查时可以让它专门 grep 一遍ENC(出现的位置和对应的jasypt.encryptor.password配置，两边对不上就是问题所在。

5.5 launch.json 里 vmArgs 和 args 混用

vmArgs传给 JVM，args传给 main 方法。-Dspring.profiles.active=test是 JVM 系统属性，必须放vmArgs。放args里 Spring 读不到，表现为 profile 没切。让 Codex 检查launch.json时明确区分这两个字段。

6. 后续怎么用这套组合

配置排查这件事，最怕的是「改了一处，另一处又盖回来」。走 TaoToken 的 Codex 好处是它能一次读全application.yml、application-{profile}.yml、launch.json和命令行参数，按优先级给你一条覆盖链，而不是让你在四个文件之间来回猜。

日常用法：每次新增 profile 或改launch.json后，让 Codex 跑一遍「列出所有 profile 激活来源并排序」的检查，几秒钟就能发现冲突。Key 的管理在 https://taotoken.net/api-keys ，接入文档在 https://taotoken.net/doc ，需要对话验证模型行为可以直接开 https://taotoken.net/chat 。如果你长期用 Codex 做编码和 Agent 任务，Coding Plan 在 https://taotoken.net/coding-plan ，Claude Code 相关接入看 https://taotoken.net/claude-code 。

最后提醒一句：TaoToken 只提供 Key 和 Base URL，SpringBoot 怎么读 yml、profile 怎么激活，还是你工程自己的事。Codex 帮你核对，改文件、跑命令、看日志这三步得你自己来。把覆盖顺序理清一次，后面多环境配置就很少再翻车了。