改完数据库密码,容器起不来。日志里 ACcess denied for user 'app'@'172.18.0.5' (using password: YES),错误码 1045。同一份密码在宿主机 mysql 客户端能连上。
密码是 p@ss$word123,写在 compose 同目录的 .env 里。进容器 printenv DB_PASSWORD,值只剩 p@ss。$word 被当成变量名,取不到值就展开成空串。
compose 会解析 .env 做变量替换,$ 后面跟合法变量名就替换。这个行为 v1 和 v2 一致,和 shell 的规则不完全一样,写脚本的人容易想当然。
先试了给值加双引号,仍然被替换。查文档才知道双引号内插值照样生效,只有单引号才是字面量。这个细节在 README 里只有一句话。
# .env 里用单引号,$ 才是字面量
DB_PASSWORD='p@ss$word123'
docker compose config | grep DB_PASSWORD
docker compose exec app printenv DB_PASSWORD | wc -c
另一个办法是写 $$,compose 会还原成单个 $。这个写法在 compose 文件和 .env 里都生效,但两处混用容易忘,最后统一改成单引号。
还有一处坑在 application.yml。Spring 的 ${DB_PASSWORD} 占位符和 compose 的 $ 不是一套东西,改完 .env 忘了改 compose 里的 environment 段,传进容器的还是旧变量名,报错一模一样。
确认方式:docker compose config 打印合并后的最终配置,肉眼核对密码原文;再进容器数一下字符长度,和源文件一致才算过。
顺带把密码里的特殊字符限制成字母数字加 @#% 三类,$ 和反引号一律不允许,写进 CI 的密码校验脚本。这条比任何转义规则都好维护。
