- 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 补充接口地址与环境变量防呆说明
106 lines
4.0 KiB
JavaScript
106 lines
4.0 KiB
JavaScript
/**
|
||
* 构建产物「接口地址」校验(防呆)
|
||
*
|
||
* 背景:本项目原 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('全部产物校验通过')
|