开发问题

本页面汇总开发相关常见问题。

环境搭建

Q: 项目如何启动？

A:

后端启动

cd miseb-mer-java
mvn clean install
mvn spring-boot:run -pl miseb-admin

前端启动

cd miseb-mer-platform  # 或 miseb-mer-merchant
npm install
npm run dev

Q: Maven依赖下载失败？

A:

1. 检查网络连接
2. 配置阿里云镜像源

<mirror>
  <id>aliyun</id>
  <mirrorOf>central</mirrorOf>
  <url>https://maven.aliyun.com/repository/central</url>
</mirror>

3. 清除本地缓存重试

mvn clean install -U

Q: npm安装依赖失败？

A:

1. 切换淘宝镜像

npm config set registry https://registry.npmmirror.com

2. 清除缓存重试

npm cache clean --force
npm install

后端开发

Q: 如何添加新接口？

A:

1. 在Controller中添加接口方法
2. 在Service中实现业务逻辑
3. 在DAO中添加数据操作
4. 测试接口

@RestController
@RequestMapping("/api/admin/xxx")
public class XxxController {

    @GetMapping("/list")
    public CommonResult<List<XxxVO>> list() {
        return CommonResult.success(xxxService.list());
    }
}

Q: 如何添加新的数据库表？

A:

1. 创建SQL脚本
2. 创建Entity实体类
3. 创建DAO接口继承BaseMapper
4. 创建Service和ServiceImpl

Q: 接口权限如何控制？

A:

使用注解控制权限：

@PreAuthorize("hasAuthority('product:list')")
@GetMapping("/list")
public CommonResult<?> list() {
    // ...
}

Q: 如何处理跨域？

A:

项目已配置全局跨域，如需修改：

@Configuration
public class CorsConfig {
    @Bean
    public CorsFilter corsFilter() {
        // 配置跨域
    }
}

前端开发

Q: 如何添加新页面？

A:

1. 在views目录下创建页面组件
2. 在router中添加路由配置
3. 在菜单中添加菜单项

Q: 如何调用后端接口？

A:

// 1. 在api目录创建接口文件
// api/xxx.js
import request from '@/utils/request'

export function getList(params) {
  return request({
    url: '/xxx/list',
    method: 'get',
    params
  })
}

// 2. 在组件中使用
import { getList } from '@/api/xxx'

const fetchData = async () => {
  const res = await getList({ page: 1 })
  console.log(res)
}

Q: 如何添加全局组件？

A:

// main.js
import MyComponent from '@/components/MyComponent.vue'
app.component('MyComponent', MyComponent)

调试相关

Q: 如何查看后端日志？

A:

开发环境查看控制台输出

生产环境：

tail -f logs/miseb.log

Q: 接口报错如何排查？

A:

1. 查看浏览器Network请求详情
2. 查看后端控制台错误日志
3. 检查请求参数是否正确
4. 检查Token是否有效

下一步

• 部署问题 - 部署相关问题
• 功能问题 - 功能相关问题