标准JavaWeb项目采用分层目录结构：src/main/java存Java类，src/main/webapp放WEB-INF/web.xml（传统）或static/templates（Spring Boot），资源路径错误会导致404或配置失效；web.xml中字符编码过滤器等配置在Spring Boot中已自动集成，可删除；JSP需置于webapp下且容器支持，否则返回源码；MySQL连接应将localhost改为127.0.0.1并配置useSSL=false。
JavaWeb项目标准目录结构长什么样
标准的JavaWeb项目不是把所有文件堆在一个文件夹里，而是遵循明确的分层约定，尤其在使用Maven构建时，src/main/java放Java类，src/main/webapp（或现代Spring Boot的src/main/resources/static和templates）放前端资源。如果你看到一个项目里WEB-INF不在webapp根下、web.xml放在src里，基本可以判断是结构混乱或IDE自动生成失败。
关键路径必须存在且位置准确：
-
src/main/java：存放com.example.controller等包结构，不能直接放.java在src根下 -
src/main/webapp/WEB-INF/web.xml（传统Servlet项目）：部署描述符，路径错一位就导致404或“no servlet found” -
src/main/webapp/static/（Spring Boot）：CSS/JS/图片等静态资源，若误放至resources/static外层，浏览器请求会返回404 -
src/main/resources/application.properties（Spring Boot）：配置文件名大小写敏感，写成Application.properties或application.config都不生效
web.xml里哪些配置现在其实可以删了
很多从2010年代教程抄来的web.xml还保留着<servlet-mapping>手动映射、<filter>显式声明字符编码过滤器等内容。Spring Boot 2.0+默认已自动注册CharacterEncodingFilter，且用@Controller+@RequestMapping替代XML映射后，整个<servlet>块都成了冗余。
典型可安全删除的片段：
立即学习“Java免费学习笔记（深入）”；
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>除非你主动禁用了Spring Boot的server.servlet.encoding自动配置，否则这段代码不仅多余，还可能和内置Filter冲突，导致中文参数乱码更难排查。
为什么你的JSP页面总显示源码而不是渲染结果
这不是JDK版本问题，也不是Tomcat没启动，而是JSP支持在现代容器中默认关闭或路径配置错误。Spring Boot 2.3+彻底移除了对JSP的支持（因为内嵌Tomcat无法加载webapp下的JSP），而独立部署到外部Tomcat时，常见错误有：
- JSP文件放在
src/main/resources/下——JSP必须在src/main/webapp/或其子目录，否则编译器根本看不到 -
web.xml里<jsp-config>缺失或<url-pattern>*.jsp</url-pattern>被注释掉 - Tomcat的
lib目录缺少jasper-el.jar和jasper.jar（常见于精简版Tomcat） - 使用了
spring-boot-starter-web但没排除spring-boot-starter-tomcat，又强行加JSP依赖，引发类加载冲突
简单验证方式：访问http://localhost:8080/your-app/hello.jsp，如果返回HTTP 200但内容是JSP原始文本，说明容器根本没触发JSP引擎，而是当纯文本返回了。
application.properties里database.url写localhost连不上MySQL怎么办
开发环境用localhost连MySQL失败，90%不是密码错了，而是MySQL默认绑定127.0.0.1而非localhost，而JDBC驱动对这两个地址的解析行为不同：localhost会走Unix socket（Linux/macOS），127.0.0.1才走TCP。Docker或WSL环境下尤其明显。
解决方法优先级排序：
- 把
spring.datasource.url中的localhost换成127.0.0.1，例如：jdbc:mysql://127.0.0.1:3306/mydb?useSSL=false&serverTimezone=UTC - 确认MySQL用户权限允许从
%或127.0.0.1连接（CREATE USER 'user'@'%' IDENTIFIED BY 'pwd'; GRANT ALL ON mydb.* TO 'user'@'%';） - Docker Compose场景下，不要用
localhost指向宿主机，改用host.docker.internal（Mac/Windows）或宿主机真实IP（Linux）
另外，useSSL=false不是可选项——MySQL 8.0+默认强制SSL，不加这个参数会抛Communications link failure异常，且错误日志里完全不提SSL的事。
