全栈的自我修养: 002使用@vue/cli进行vue.js环境搭建 (使用Vue,Spring Boot,Flask,Django 完成Vue前后端分离开发)

全栈的自我修养: 使用@vue/cli进行vue.js环境搭建

Success, real success, is being willing to do the things that other people are not.

成功,真正的成功,是愿意做别人不愿意做的事情。

全栈的自我修养: 001环境搭建 (使用Vue,Spring Boot,Flask,Django 完成Vue前后端分离开发)

全栈的自我修养: 002使用@vue/cli进行vue.js环境搭建 (使用Vue,Spring Boot,Flask,Django 完成Vue前后端分离开发)

全栈的自我修养: 003Axios 的简单使用

Table of Contents

当你看到这篇文章的时候,暂且认为你对如何做一个网站有了兴趣.

前言

上一篇讲述了使用 vue-cli 搭建 epimetheus-frontend, 在一些老项目中确实是这样的, 不过前端框架发版就和坐火箭🚀一样, 你方唱罢我登场, 一代新人换旧人, 今天来介绍下 @vue/cli 的使用

Vue CLI 是一个基于 Vue.js 进行快速开发的完整系统,提供:

  • 通过 @vue/cli 实现的交互式的项目脚手架。
  • 通过 @vue/cli + @vue/cli-service-global 实现的零配置原型开发。
  • 一个运行时依赖 (@vue/cli-service),该依赖:
    • 可升级;
    • 基于 webpack 构建,并带有合理的默认配置;
    • 可以通过项目内的配置文件进行配置;
    • 可以通过插件进行扩展。
  • 一个丰富的官方插件集合,集成了前端生态中最好的工具。
  • 一套完全图形化的创建和管理 Vue.js 项目的用户界面。

Vue CLI 致力于将 Vue 生态中的工具基础标准化。它确保了各种构建工具能够基于智能的默认配置即可平稳衔接,这样你可以专注在撰写应用上,而不必花好几天去纠结配置的问题。与此同时,它也为每个工具提供了调整配置的灵活性,无需 eject。

Vue CLI 的介绍来自于官网,文末有对应的参考地址

删代码,不用跑路

删代码,作为程序员来说应该是一件非常身心愉悦的事情

在上一篇文档我们已经使用老版的 vue-cli 创建了 epimetheus-frontend, 首先第一步我们先删除了他

epimetheus$ rm -rf epimetheus-frontend

因为新老版本的 vue cli 都是使用的 vue 命令,此时需要把上次安装的 vue-cli 卸载

epimetheus$ npm uninstall vue-cli -g

这样我们又有一个干净的环境了

Node 版本要求


Vue CLI 需要 Node.js 8.9 或更高版本 (推荐 8.11.0+)。

安装@vue/cli

在上篇中,我们使用了 npm install -g vue-cli 完成 vue-cli 的安装

作为新版本,Vue CLI 的包名称由 vue-cli 改成了 @vue/cli. 我们需要执行以下命令安装

epimetheus$ npm install -g @vue/cli

安装速度还是比较慢的,大家可以喝杯水

安装完成后可以 vue --version 看下版本号

epimetheus$ vue --version
@vue/cli 4.4.6

创建 Vue 项目

这里我们继续创建一遍 epimetheus-frontend

  1. 我们还是进入上次创建的 epimetheus 目录
  2. 执行 vue create epimetheus-frontend 创建项目

第一步会提示选择一个preset, 这里选择默认的 Babel + ESLint

第二步会提示选择package manager, 这里我们还是选择 Yarn

安装过程可能有点慢,安装完成后,如下

epimetheus$ vue create epimetheus-frontend


Vue CLI v4.4.6
? Please pick a preset: default (babel, eslint)
? Pick the package manager to use when installing dependencies: Yarn


Vue CLI v4.4.6
✨  Creating project in /Users/zhangyunan/project/scoding/epimetheus/epimetheus-frontend.
🗃  Initializing git repository...
⚙️  Installing CLI plugins. This might take a while...

yarn install v1.15.2
info No lockfile found.
[1/4] 🔍  Resolving packages...



success Saved lockfile.
info To upgrade, run the following command:
$ curl --compressed -o- -L https://yarnpkg.com/install.sh | bash
✨  Done in 30.95s.
🚀  Invoking generators...
📦  Installing additional dependencies...

yarn install v1.15.2
[1/4] 🔍  Resolving packages...
[2/4] 🚚  Fetching packages...
[3/4] 🔗  Linking dependencies...
[4/4] 🔨  Building fresh packages...

success Saved lockfile.
✨  Done in 5.79s.
⚓  Running completion hooks...

📄  Generating README.md...

🎉  Successfully created project epimetheus-frontend.
👉  Get started with the following commands:

 $ cd epimetheus-frontend
 $ yarn serve

从上面的提示中,我们看到默认创建了一个 git 项目.

根据最后提示,我们可以进入 epimetheus-frontend, 并在控制台运行 yarn serve,即可开始运行我们的项目

epimetheus$ cd epimetheus-frontend
epimetheus/epimetheus-frontend$ (master) yarn serve
yarn run v1.15.2
$ vue-cli-service serve
 INFO  Starting development server...
98% after emitting CopyPlugin

 DONE  Compiled successfully in 2275ms                                                         下午10:13:29


  App running at:
  - Local:   http://localhost:8080/
  - Network: http://192.168.1.4:8080/

  Note that the development build is not optimized.
  To create a production build, run yarn build.

从控制台信息可以看出,访问路径为:http://localhost:8080

在这里插入图片描述

这样准备工作基本就完成了

项目结构

相信开发上篇文档,已经可以使用 code 命令,如果还是不能使用,可以根据下面的提示进行安装,这里我们直接使用 code . 打开当前目录

例如:

epimetheus/epimetheus-frontend$  code .

则会将当前文件夹 epimetheus/epimetheus-frontendVSCode 中打开,

如何你安装 VSCode 后,使用 code 命令时,提示 not fund, 可以通过 查看 -> 命令面板 输入 code 进行安装

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-jvkCJ2Uz-1593393770883)(img/vscode_install_code.png)]

这里使用了 VSCode,打开项目后如图:

在这里插入图片描述

├── README.md                 # Default README file
├── babel.config.js
├── package.json              # build scripts and dependencies
├── public
│   ├── favicon.ico
│   └── index.html            # index.html template
├── src
│   ├── App.vue               # main app component
│   ├── assets                # module assets
│   │   └── logo.png
│   ├── components
│   │   └── HelloWorld.vue
│   └── main.js               # app entry file
└── yarn.lock

vue-cli3.0修改端口号

其中,我们主要修改 src 下文件,上面提到项目访问端口为:8080, 为了防止与其他项目造成冲突,这里将端口改为:7000, 提供两种方式:

  1. package.json文件下修改 --port
"scripts": {
   "serve": "vue-cli-service serve --port 7000",
}
  1. package.json 同级目下创建 vue.config.js, 并添加以下内容
module.exports = {
  devServer: {
    port: 7000
  }
}

两种方式均可

使用 elementUI

这里使用了
官网:http://element-cn.eleme.io/#/zh-CN/component/installation

这里我们进入刚才的项目目录:并执行 yarn add element-ui

并配置 main.js

import Vue from 'vue'

import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';

import App from './App.vue'

Vue.use(ElementUI);

Vue.config.productionTip = false

new Vue({
  render: h => h(App),
}).$mount('#app')

安装 Vuex

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。Vuex 也集成到 Vue 的官方调试工具 devtools extension,提供了诸如零配置的 time-travel 调试、状态快照导入导出等高级调试功能。

也就是通过 Vuex ,各个组件可以实时的共享状态

官网:https://vuex.vuejs.org/zh-cn/intro.html

安装

首先我们先安装它 yarn add vuex

配置

首先在 src 下创建 store 文件夹并在其下创建 store.js 文件
src/store/store.js, 同时创建 src/assets/util/cookie.js

src/assets/utils/cookie.js 文件内容

该文件主要用于操作cookie

let cookie = {
  setCookie (cname, value, expiredays) {
    let exdate = new Date()
    exdate.setTime(exdate.getTime() + expiredays)
    exdate.setDate(exdate.getDate() + expiredays) 
    document.cookie = cname + '=' + escape(value) + ((expiredays == null) ? '' : ';expires=' + exdate.toGMTString())
  },
  getCookie (name) {
    let reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)')
    let arr = document.cookie.match(reg)
    if (arr) {
      return (arr[2])
    } else {
      return null
    }
  },
  delCookie (name) {
    let exp = new Date()
    exp.setTime(exp.getTime() - 1)
    let cval = cookie.getCookie(name)
    if (cval != null) {
      document.cookie = name + '=; expires=Thu, 01 Jan 1970 00:00:01 GMT;'
    }
  }
}

export default cookie

src/store/store.js 内容

这里定义了 userInfo 用来保存当前的用户信息,包含一个 nametoken

import Vue from 'vue'
import Vuex from 'vuex'
import cookie from '../assets/utils/cookie'

Vue.use(Vuex)

const userInfo = {
  name: cookie.getCookie('name') || '',
  token: cookie.getCookie('token') || ''
}

const store = new Vuex.Store({
  state: {
    userInfo: userInfo
  },
  mutations: {
    setUserInfo (state) {
      state.userInfo = {
        name: cookie.getCookie('name'),
        token: cookie.getCookie('token'),
      }
    }
  }
})

export default store

main.js 添加Vuex配置,

import Vue from 'vue'

import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';
import store from './store/store'

import App from './App.vue'

Vue.use(ElementUI);

Vue.config.productionTip = false

new Vue({
  store,
  render: h => h(App),
}).$mount('#app')

安装 axios

Promise based HTTP client for the browser and node.js

axios 是一个基于 Promise 的 http client, 通过他,我们向后端进行数据交互,如果你不喜欢它,可以使用jqueryajax 代替.

我们来安装一下 yarn add axios

最终 main.js

import Vue from 'vue'

import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';
import store from './store/store'

import App from './App.vue'

Vue.use(ElementUI);

Vue.config.productionTip = false

new Vue({
  store,
  render: h => h(App),
}).$mount('#app')

github

https://github.com/zhangyunan1994/epimetheus-frontend

参考

  • @vue/cli : https://cli.vuejs.org/zh/guide/

在这里插入图片描述

发送请求: POST /api/admin/library-files :5000/api/admin/library-files:1 Failed to load resource: the server responded with a status of 422 (UNPROCESSABLE ENTITY) index.js:50 API请求错误: AxiosError (anonymous) @ index.js:50 AdminTransport.vue:567 主要上传方法失败,尝试备用方法: AxiosError submitFiles @ AdminTransport.vue:567 AdminTransport.vue:571 尝试使用备用URL: http://localhost:5000/api/admin/library-files-alt :5000/api/admin/library-files-alt:1 Failed to load resource: the server responded with a status of 422 (UNPROCESSABLE ENTITY) AdminTransport.vue:589 备用上传方法也失败: AxiosError submitFiles @ AdminTransport.vue:589 AdminTransport.vue:593 备用方法错误响应: Object submitFiles @ AdminTransport.vue:593 AdminTransport.vue:594 备用方法状态码: 422 submitFiles @ AdminTransport.vue:594 AdminTransport.vue:647 API错误: AxiosError submitFiles @ AdminTransport.vue:647 AdminTransport.vue:653 错误响应状态: 422 submitFiles @ AdminTransport.vue:653 AdminTransport.vue:654 错误响应数据: Object submitFiles @ AdminTransport.vue:654 AdminTransport.vue:655 请求URL: http://localhost:5000/api/admin/library-files-alt submitFiles @ AdminTransport.vue:655 AdminTransport.vue:656 请求方法: post submitFiles @ AdminTransport.vue:656 AdminTransport.vue:657 请求头: AxiosHeaders submitFiles @ AdminTransport.vue:657 AdminTransport.vue:687 提交失败详细信息: Error: 上传文件失败 at submitFiles (AdminTransport.vue:684:13) submitFiles @ AdminTransport.vue:687
最新发布
08-15
<think>首先,用户的问题是关于上传文件时遇到422错误。他们尝试了主备两种API接口:`http://localhost:5000/api/admin/library-files` 和 `library-files-alt`,但都失败了,返回422错误。错误是AxiosError。用户需要帮助排查原因。 422错误通常表示"Unprocessable Entity",意思是服务器理解请求,但由于某种原因无法处理。常见原因包括: - 请求体格式错误(如JSON无效) - 缺少必需字段 - 数据类型不匹配 - 文件上传相关问题(如文件格式不支持、文件大小超限) 用户提到上传文件,所以焦点在文件上传部分。参考引用的内容: - 引用[1]:描述了Django应用程序中处理收据图像上传的过程。它涉及使用`request.FILES['image']`获取文件,编码图像,发送到OpenAI API,然后存储到数据库。这暗示了文件上传的机制。 - 引用[2]:是关于Hugo站点的设置,与文件上传无关。 - 引用[3]:是关于数据库表结构,存储下载资源信息,如资源名、链接、提取码。这可能与文件存储相关,但不直接帮助。 用户的问题具体是关于API接口返回422错误,所以需要基于常见的HTTP错误和文件上传最佳实践来排查。 ### 步骤排查422错误: 1. **检查请求方法**:确保使用POST方法。422错误可能由于方法不正确。 2. **检查请求头**:特别是`Content-Type`。对于文件上传,通常需要`multipart/form-data`。如果使用JSON或其他格式,可能不匹配。 3. **检查请求体**: - 对于文件上传,请求体应包含文件数据。 - 确保字段名正确。例如,在引用[1]中,使用`request.FILES['image']`,所以字段名可能是'image'或类似。 - 如果有其他字段(如认证令牌),确保它们正确。 4. **文件相关**: - 文件大小:服务器可能有大小限制。 - 文件类型:服务器可能只支持特定类型(如jpg, png)。 - 文件是否为空或损坏。 5. **认证和授权**:接口可能需要API密钥、token或其他认证。如果缺失或无效,可能导致422或401/403。 6. **API文档**:用户应检查API文档(如果有),了解正确格式。 7. **服务器日志**:查看服务器端日志,可能提供更详细的错误信息。 8. **Axios配置**:既然错误是AxiosError,检查Axios请求配置: - URL是否正确。 - Headers设置。 - Data格式。 - 错误处理代码。 ### 基于用户描述: - 用户尝试了主备接口,都失败,所以问题可能出在请求本身或服务器配置。 - 错误是422,指向请求数据问题。 ### 建议的排查步骤: 1. **验证请求格式**:确保使用`multipart/form-data`作为Content-Type,并正确附加文件。 2. **检查字段名**:确认API期望的文件字段名是什么。例如,是'file'还是'image'?参考引用[1]使用'image'。 3. **测试简单文件**:尝试上传一个小文件(如小文本文件)以排除文件大小或类型问题。 4. **检查服务器响应**:AxiosError应包含响应数据。打印响应体以获取更多细节。422响应通常包括错误消息,如缺少字段或无效数据。 5. **认证检查**:如果API需要认证,确保在请求中包含(如Authorization头)。 6. **CORS问题**:如果前端和后端不同源,可能有CORS问题,但422错误更可能是数据问题而非CORS。 ### 生成相关问题: 根据系统指令,我需要生成相关问题。问题应基于用户的问题,帮助深入探讨。 相关问题: 1. 如何检查Axios请求的详细错误响应? 2. 文件上传API的最佳实践是什么? 3. 如何调试HTTP 422错误在RESTful API中? 4. 服务器端如何处理文件上传请求? 5. 常见的文件上传错误有哪些以及如何解决? ### 回答结构: - 清晰、逐步地解释如何排查。 - 使用中文。 - 确保真实可靠。 - 在末尾添加引用标识(如果适用)。引用[1]涉及文件上传,所以可以引用。 - 数学表达式:用户问题中没有数学,所以不需要。</think>### 排查上传文件返回422错误的原因 当您使用Axios向`http://localhost:5000/api/admin/library-files`或`library-files-alt`接口发送POST请求上传文件时,返回HTTP 422(Unprocessable Entity)错误,表示服务器理解请求但无法处理数据。这通常与请求数据格式、文件内容或服务器验证规则相关。以下是基于常见问题的逐步排查指南,帮助您定位原因。我会尽量保证回答真实可靠,基于HTTP规范、文件上传最佳实践和您提供的引用信息。 --- ### 1. **检查请求格式和内容(最常见原因)** - **Content-Type头设置**: - 文件上传必须使用`multipart/form-data`格式。如果您的请求头设置为`application/json`或其他类型,服务器无法解析文件数据,导致422错误。 - 示例Axios配置: ```javascript const formData = new FormData(); formData.append('file', file); // 'file'是字段名,需与API文档一致 axios.post('http://localhost:5000/api/admin/library-files', formData, { headers: { 'Content-Type': 'multipart/form-data', // 必须设置 'Authorization': 'Bearer your_token' // 如果需要认证 } }); ``` - **验证方法**:在浏览器开发者工具(Network标签)或Postman中检查请求头。如果缺失或错误,修正后重试。 - **字段名是否正确**: - 服务器可能要求文件字段名为特定值(如`file`、`image`或`upload`)。参考引用[1]中Django处理文件时使用`request.FILES['image']`,表明字段名需匹配(这里是`'image'`)。 - **排查步骤**: - 检查API文档确认字段名。 - 如果无文档,尝试常见字段名如`file`或`image`。 - 错误示例:如果字段名错误(如`formData.append('files', file)`),服务器无法识别,返回422。 - **文件大小或类型限制**: - 服务器可能限制文件大小(如最大10MB)或类型(如只接受PDF、JPG)。超过限制会触发422。 - **验证方法**: - 尝试上传一个小文件(如1KB的文本文件)测试。 - 检查服务器日志或API响应体(见下文),错误消息可能提示`File too large`或`Invalid file type`。 --- ### 2. **检查请求数据和认证(次要原因)** - **缺失必需字段**: - 除了文件,API可能要求附加数据(如用户ID、分类ID)。缺失这些字段会导致422。 - 示例:如果API需要`category_id`,但请求中未包含: ```javascript formData.append('file', file); formData.append('category_id', 123); // 必需字段 ``` - **排查步骤**:参考API文档或服务器代码,确认必需字段。若无文档,检查类似引用[1]中的负载结构。 - **认证问题**: - 接口可能需要API密钥、Token或Cookie。如果认证无效或缺失,服务器可能返回422(而非401/403),表示数据无法处理。 - **验证方法**: - 确保请求头包含认证信息(如`Authorization: Bearer <token>`)。 - 测试其他需认证的接口(如登录API),确认Token有效。 - **数据格式错误**: - 如果请求包含JSON或其他结构化数据(如文件元数据),格式错误(如字符串未转义、数组格式错误)会触发422。 - **排查步骤**:使用Postman构建请求,确保JSON有效。或简化请求,只传文件测试。 --- ### 3. **分析服务器响应和日志(关键步骤)** - **获取详细错误信息**: - AxiosError对象包含响应体,通常有具体错误消息。打印响应数据: ```javascript axios.post(url, data, config) .catch(error => { console.error('Error details:', error.response.data); // 查看错误消息 }); ``` - 422响应体示例: ```json { "error": "Missing required field: 'category'", "code": 422 } ``` 这能直接定位问题字段或规则。 - **检查服务器日志**: - 登录服务器,查看应用日志(如Django日志或Node.js控制台输出)。引用[1]中Django视图处理文件时,错误可能记录在`views.py`的异常处理中。 - 常见日志位置: - Django:`logs/error.log` 或控制台输出。 - Node.js/Express:终端或PM2日志。 - 日志可能提示:`File validation failed`或`Unsupported media type`。 - **验证服务器端代码**: - 如果API是您开发的,检查文件处理逻辑: - 文件解析是否支持您的格式(如引用[1]中`encode_image`函数可能只处理图像)。 - 数据库约束:引用[3]中表结构有字段限制(如`dname`长度),文件元数据插入失败可能触发422。 - 中间件问题:如CSRF验证(引用[1]使用`@csrf_exempt`,但您的API可能需要类似处理)。 --- ### 4. **其他常见原因** - **CORS问题**:如果前端与`localhost:5000`不同源,浏览器可能阻塞请求,但CORS通常返回CORS错误而非422。确保服务器配置CORS头(如`Access-Control-Allow-Origin: *`)。 - **文件损坏或空文件**:上传空文件或损坏文件可能被服务器拒绝。测试不同文件。 - **网络问题**:Axios超时设置不当可能导致部分数据丢失。增加超时时间: ```javascript axios.post(url, data, { timeout: 30000 }); // 30秒超时 ``` - **备份接口问题**:`library-files-alt`也失败,表明问题可能在请求端或服务器配置,而非单个接口。 --- ### 总结建议 - **优先步骤**:检查Content-Type头、字段名和文件属性(大小/类型),这些占422错误的80%。然后分析响应体和服务器日志。 - **测试工具**:用Postman或cURL发送请求,隔离前端问题: ```bash curl -X POST http://localhost:5000/api/admin/library-files \ -H "Content-Type: multipart/form-data" \ -F "file=@/path/to/test.jpg" ``` - 如果问题持续,提供更多细节(如请求代码、响应体、服务器框架),我可进一步分析。 [^1]: 引用[1]中Django文件处理流程强调了字段名和格式的重要性,类似问题可能适用于您的API。 --- ### 相关问题 1. 如何从AxiosError中提取详细的HTTP错误信息? 2.DjangoFlask中,如何正确处理文件上传并避免422错误? 3. HTTP 422与其他4xx错误(如400或403)有什么区别? 4. 如何配置服务器日志以捕获文件上传错误? 5. 文件上传API的安最佳实践有哪些(如防恶意文件)?
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值