WMS_PDA/scripts/check-build-env.cjs
liufumingren ba33f9c59a fix(env): 生产地址防呆,避免开发地址打进正式包
- src/env.js:生产构建固定 PROD_API_BASE,开发地址只从 .env.development.local 注入,源码不再保留内网地址字面量
- 新增 scripts/check-build-env.cjs:扫描产物含内网地址或缺生产域名即中止构建,已挂到 build:h5 / build:app-plus,另有 npm run check:env
- 新增 .env.example 模板;开发变量改用 mode 专属的 .env.development.local(.env.local 在 production 模式也会被加载并注入客户端代码)
- README 补充接口地址与环境变量防呆说明
2026-10-02 20:17:23 +08:00

106 lines
4.0 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/**
* 构建产物「接口地址」校验(防呆)
*
* 背景:本项目原 HBuilderX 工程里 src/env.js 的开发地址长期处于生效状态,
* 打正式包时会连内网测试库(曾在姊妹项目 wms_worker_station 造成过生产事故)。
* 本脚本在构建结束后扫描产物,做两道校验:
* 1. 产物中不得出现内网地址(192.168.x.x / 127.0.0.1)——否则说明开发地址进了包;
* 2. 产物中必须出现生产域名 PROD_HOST——否则说明生产地址根本没被编译进去
* (例如误用了 override、或 env.js 被改坏)。
* 任一条不满足即 exit 1,让 CI / 本地打包在「产物不可信」时就停下来。
*
* 用法:
* node scripts/check-build-env.cjs # 自动扫描已存在的产物目录
* node scripts/check-build-env.cjs dist/build/h5 # 只校验指定目录
* node scripts/check-build-env.cjs --allow-missing-prod # 跳过第 2 条(特殊域名场景)
*/
const fs = require('fs')
const path = require('path')
const ROOT = path.resolve(__dirname, '..')
const DEFAULT_TARGETS = [path.join(ROOT, 'dist', 'build', 'h5'), path.join(ROOT, 'dist', 'build', 'app-plus')]
const SCAN_EXTENSIONS = ['.js', '.html', '.json', '.css']
// 生产接口域名:必须与 src/env.js 的 PROD_API_BASE 保持一致
const PROD_HOST = 'qimen.wms.gztbyc.com'
// 内网地址特征(开发环境地址一旦出现在产物里就是事故)
const DEV_PATTERNS = [/192\.168\.\d{1,3}\.\d{1,3}/g, /127\.0\.0\.1/g]
const args = process.argv.slice(2)
const allowMissingProd = args.includes('--allow-missing-prod')
const explicitTargets = args.filter((arg) => !arg.startsWith('--'))
const log = (...rest) => console.log('[check-build-env]', ...rest)
function collectFiles(dir, out = []) {
if (!fs.existsSync(dir)) return out
for (const name of fs.readdirSync(dir)) {
const full = path.join(dir, name)
const stat = fs.statSync(full)
if (stat.isDirectory()) {
collectFiles(full, out)
} else if (SCAN_EXTENSIONS.includes(path.extname(name).toLowerCase())) {
out.push(full)
}
}
return out
}
const targets = (explicitTargets.length ? explicitTargets : DEFAULT_TARGETS)
.map((target) => path.resolve(ROOT, target))
.filter((dir) => fs.existsSync(dir))
if (!targets.length) {
console.error('[check-build-env] ✗ 未找到任何构建产物目录,请先执行构建(npm run build:h5 / build:app-plus)')
process.exit(1)
}
let failed = false
for (const dir of targets) {
const files = collectFiles(dir)
const rel = path.relative(ROOT, dir).replace(/\\/g, '/')
if (!files.length) {
log(`✗ ${rel} 为空目录,跳过`)
continue
}
const devHits = []
let hasProdHost = false
for (const file of files) {
const content = fs.readFileSync(file, 'utf-8')
if (content.includes(PROD_HOST)) hasProdHost = true
for (const pattern of DEV_PATTERNS) {
const matches = content.match(pattern)
if (matches) {
devHits.push({ file: path.relative(dir, file).replace(/\\/g, '/'), hits: Array.from(new Set(matches)) })
break
}
}
}
if (devHits.length) {
failed = true
console.error(`[check-build-env] ✗ ${rel} 中发现内网地址,产物不可用于发布:`)
devHits.forEach(({ file, hits }) => console.error(` - ${file}(${hits.join(', ')})`))
console.error(' 排查:src/env.js 是否被改回开发地址 / 是否误用 VUE_APP_API_BASE_OVERRIDE')
}
if (!hasProdHost && !allowMissingProd) {
failed = true
console.error(`[check-build-env] ✗ ${rel} 中未发现生产域名 ${PROD_HOST},产物不可用于发布`)
console.error(' 排查:src/env.js 的 PROD_API_BASE 是否被改动;如属特殊场景请加 --allow-missing-prod')
}
if (!devHits.length && (hasProdHost || allowMissingProd)) {
log(`✓ ${rel} 校验通过(${files.length} 个文件,无内网地址${hasProdHost ? `,含生产域名 ${PROD_HOST}` : ''})`)
}
}
if (failed) {
console.error('[check-build-env] ✗ 校验未通过,已中止')
process.exit(1)
}
log('全部产物校验通过')