vite打包靜態(tài)文件打開顯示空白的解決
需求場景
- 本地調(diào)試訪問打包的文件看是否有啥問題,方便定位線上問題
- 安卓手機需要去直接訪問靜態(tài)文件,而不是訪問域名的情況
vite 打包生成的文件如果直接放在服務(wù)器中是可以正常訪問的,但是本地直接訪問打包生成index.html
文件就會提示以下問題。
- 訪問的文件不存在,主要是因為路徑配置問題。
- 提示跨域問題,不支持files協(xié)議,主要是因為esModule問題。
問題1:訪問的文件不存在,主要是因為路徑配置問題。
解決:在 vite.config.js
文件中配置
export default defineConfig({ ... base: "./", ... })
驗證路徑是否正常看瀏覽器中的network看文件是否加載正常
問題2. 提示跨域問題,不支持files協(xié)議,主要是因為esModule問題
對比webpack 打包靜態(tài)文件是否可以正常訪問
答案:正常
在vue.config.js 文件中配置
module.exports = { outputDir: 'dist', publicPath: baseUrl,
原理:開始通過file協(xié)議直接訪問index.html,在index.html中靜態(tài)引入index.js,在index.js中import test.js。在import的過程中需要http服務(wù)器去解析es6語法并添加header頭信息去跨域引入test.js,但是file協(xié)議相當(dāng)于通過資源管理器靜態(tài)訪問index.html,中間的過程沒有http服務(wù)器參與解析,所以無法識別es6的import語法。
解決:將打包生成的文件改成為沒有moudle的文件
step1:安裝
$ npm install @vitejs/plugin-legacy
step2: 配置vite.config.js
import legacy from '@vitejs/plugin-legacy'; export default defineConfig({ .... plugins: [legacy({ targets: ['defaults', 'not IE 11'] }),vue()], build:{ target: ['es2015', 'chrome63'], // 默認是modules,百度說是更改這個會去輸出兼容瀏覽器,嘗試沒啥作用,先配置吧 } .... })
step3:
在dist并列的文件夾中創(chuàng)建腳本文件 (用于替換module等關(guān)鍵詞,省的每次得手動刪除)toFile.cjs
創(chuàng)建 toFiles.cjs (為啥格式不是js為了執(zhí)行命令不報兼容的錯誤)
import fs from 'fs'; console.time('轉(zhuǎn)換耗時'); const distPath = './dist/index.html';//打包路徑的index.html let htmlText = fs.readFileSync(distPath, 'utf8'); let resultText = ''; let htmlArr = htmlText.match(/.*\n/g) || []; htmlArr.forEach(str => { str = str.replace(/\s?nomodule\s?/g,' '); str = str.replace(/\s?crossorigin\s?/g,' '); str = str.replace(/data-src/g,'src'); if(!/type="module"/i.test(str)) resultText += str; }); fs.writeFileSync(distPath,resultText,'utf8'); console.timeEnd('轉(zhuǎn)換耗時');
step4:
npm install fs // 安裝fs node toFile.cjs // 執(zhí)行腳本
step5: 查看 dist 文件夾中的 index.html
文件,查看是否沒有module 、 crossorigin 等關(guān)鍵詞,訪問index.html
文件 查看效果
一般執(zhí)行到這里基本是可以正常訪問的,但是我的項目還是空白,后面觀察加載的html結(jié)構(gòu)發(fā)現(xiàn)router-view的組件沒有加載上去,后面嘗試將router.js 文件中history模式改成了hash,然后再重新打包執(zhí)行上面的操作能夠正常打開。
總結(jié):
vite生成的文件會帶有module,導(dǎo)致存在跨域問題,大多數(shù)項目開發(fā)都是將文件放在服務(wù)器中通過域名去訪問,但是特殊情況需要直接訪問靜態(tài)資源。所以要去解決file存在跨域的問題。
反思:
- webpack為啥打包出的文件同樣是file直接訪問但是不存在跨域。
- webpack為啥打包出的文件不帶module,但是file打包會帶module。
借鑒其他的博文總結(jié):
1、給引用文件設(shè)置type="module"等于給文件設(shè)置了私有作用域,xx.js文件成了單獨的模塊,運行在自己的私有作用域中,而不是全局作用域中。
2、雖然script標(biāo)簽自帶跨域能力(這也是某些場合會通過jsonp結(jié)合script來請求資源的原因),但是這里的跨域是指的http協(xié)議(協(xié)議、域名、端口一致),file協(xié)議是不支持跨域的。
3、es6聲明type=“module”,這類使用了模塊的script是受限于同源策略的。
參考:
到此這篇關(guān)于vite打包靜態(tài)文件打開顯示空白的解決的文章就介紹到這了,更多相關(guān)vite打包靜態(tài)文件空白內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
vue3中el-table實現(xiàn)多表頭并表格合并行或列代碼示例
這篇文章主要給大家介紹了關(guān)于vue3中el-table實現(xiàn)多表頭并表格合并行或列的相關(guān)資料,文中通過代碼介紹的非常詳細,對大家學(xué)習(xí)或者使用vue具有一定的參考借鑒價值,需要的朋友可以參考下2024-02-02使用Vue-Router 2實現(xiàn)路由功能實例詳解
vue-router 2只適用于Vue2.x版本,下面我們是基于vue2.0講的如何使用vue-router 2實現(xiàn)路由功能,需要的朋友可以參考下2017-11-11詳解基于element的區(qū)間選擇組件校驗(交易金額)
這篇文章主要介紹了詳解基于element的區(qū)間選擇組件校驗(交易金額),文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-01-01