NodeJS通过yarn脚本结合start-server-and-test设置PERCY_TOKEN失效问题

配置失效的核心原因 #

你遇到的环境变量传递失败，本质是对shell环境变量的作用域规则理解和脚本写法不匹配：

1. 原percy:local脚本末尾带分号，且没有把环境变量绑定到后续要执行的目标进程上
2. 原cy:percy:local通过yarn percy:local && yarn start:server percy:exec串联两个独立yarn调用的写法，会因为每次yarn执行新脚本都会启动全新的shell上下文，导致之前临时设置的环境变量完全无法传递到后续的Percy进程中。

Percy官方给出的参考命令格式PERCY_TOKEN=aaabbbcccdddeeefff PERCY_BRANCH=local npm test，核心逻辑是把环境变量写在同一条待执行命令的最前端，临时将变量注入这条命令启动的整个子进程树，而非设置完变量后跳转执行完全独立的新命令。

原配置的两处具体问题 #

• 原percy:local脚本末尾的分号会让整条命令变成「仅执行变量赋值、不启动任何业务进程」的空操作；就算去掉末尾的分号，设置的变量也仅在当前临时shell块生效，不会溢出到其他上下文
• 靠&&串联两个独立yarn命令的逻辑完全切断了环境变量的传递路径：前序完成变量赋值的临时shell退出后，变量不会保留到下一个新启动的测试执行进程中，最终就会触发Skipping visual tests. PERCY_TOKEN was not provided.的告警

可正常运行的配置方案 #

按照shell环境变量的注入规则，将PERCY_TOKEN、PERCY_BRANCH直接写在整条串联执行命令的最前面，让变量沿着start:server的进程树依次传递到前端dev server、Cypress runner、Percy子进程，不需要拆分两个独立的脚本调用。
调整后的可正常执行的脚本配置为：

"percy:local": "PERCY_TOKEN=$(grep 'PERCY_TOKEN.*' .env | sed 's/.*=//') PERCY_BRANCH=local yarn start:server 'percy exec cypress run'"

这个配置能生效的原因：

• 没有拆分独立脚本调用、没有靠&&切断进程上下文的传递链路
• 环境变量从最外层命令入口开始注入，会沿着整个进程树向下传递，最终Percy进程可以正常读取到PERCY_TOKEN，不会跳过视觉测试流程

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