Bootstrap/PHP站点自定义JS/JQuery文件无法生效求助排查

我正在开发一个基于Bootstrap、JQuery/JS、PHP、MySQL的站点，目前遇到自定义JS文件无法正常工作的问题：Bootstrap的CSS和JS CDN均能正常运行，但自定义JS文件完全失效——比如尝试用JQuery给菜单添加active类的代码没有效果，其他自定义JS功能也无法执行，看起来像是文件未正确关联。我是PHP新手，采用组件化开发方式（将header、footer等作为组件，其他文件为页面），相关代码如下：

footer.php 代码 #

<footer class="site-footer text-center fixed-bottom">
            <p>&copy; 2024 PHP Site | All rights reserved.</p>
        </footer>

    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.js" integrity="sha512-+k1pnlgt4F1H8L7t3z95o3/KO+o78INEcXTbnoJQ/F2VqDVhWoaiVml/OEHv9HsVgxUaVW+IbiZPUJQfF/YxZw==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-C6RzsynM9kWDrMNeT87bh95OGNyZPhcTNXj1NW7RuBCsyN/o0jlpcV8Qyq46cDfL" crossorigin="anonymous"></script>
    <script src="js/class-active.js"></script>
</body>

</html>

header.php 代码 #

<?php session_start(); ?>
<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title><?php echo $pageTitle; ?> | <?php echo $siteTitle; ?></title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-T3c6CoIi6uLrA9TneNEoa7RxnatzjcDSCmG1MXxSR1GAsXEV/Dwwykc2MPK8M2HN" crossorigin="anonymous">
    <link rel="stylesheet" type="text/css" href="css/index.css">
</head>

<body>
    <header class="site-header">
    <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
            <div class="container-fluid">
                <a class="navbar-brand" aria-current="page" href="index.php"><img class="house-img" src="img/house.png"></a>
                <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
                    <span class="navbar-toggler-icon"></span>
                </button>
                <div class="collapse navbar-collapse" id="navbarSupportedContent">
                    <ul class="navbar-nav mx-auto mb-2 mb-lg-0 d-flex justify-content-between">
                        <li class="nav-item" id="navigation-about">
                            <a class="nav-link" href="about.php">About Us</a>
                        </li>
                        <li class="nav-item" id="navigation-menu">
                            <a class="nav-link" href="#">Menu Item</a>
                        </li>
                        <li class="nav-item" id="navigation-faq">
                            <a class="nav-link" href="faq.php">FAQ</a>
                        </li>
                        <?php
                        if (isset($_SESSION['user_id'])) {
                            echo '<li class="nav-item" id="navigation-logout">
                                    <a class="nav-link" href="logout.php">Log Out</a>
                                  </li>';
                        } else {
                            echo '<li class="nav-item dropdown">
                                    <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
                                        Login
                                    </a>
                                    <ul class="dropdown-menu">
                                        <li><a class="dropdown-item" id="nav-login" href="login.php">Log In</a></li>
                                        <li><a class="dropdown-item" id="nav-register" href="sign-up.php">Register</a></li>
                                    </ul>
                                  </li>';
                        }
                        ?>

                    </ul>
                    <form class="d-flex" role="search">
                        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
                        <button class="btn btn-outline-success" type="submit">Search</button>
                    </form>
                </div>
            </div>
        </nav>
    </header>

about.php 代码 #

<?php
include 'config.php';
$pageTitle = "About Us";
include 'header.php';
?>

    <h1 class="text-center mt-5"><?php echo $pageTitle; ?></h1>

    <?php include 'footer.php'; ?>

自定义JQuery代码（class-active.js） #

$(document).ready(function() {
    $('.nav-item a').on('click', function() {
        $('.nav-item a').removeClass('active');
        $(this).addClass('active');
    });
});

我已在footer.php中引入所有脚本，请问问题出在哪里？

核心问题1：页面跳转导致JS效果丢失 #

点击about.php这类跳转链接时，浏览器会重新加载整个页面，JS添加的active类会在页面刷新后完全重置——因为JS是客户端运行代码，页面跳转后所有DOM状态都会被清空，你的点击事件只能在跳转前瞬间生效，刷新后就消失了。

核心问题2：JS文件路径可能错误 #

如果你的PHP文件放在子目录（比如pages/about.php），相对路径js/class-active.js会指向pages/js/class-active.js，而非网站根目录的js文件夹，导致文件加载失败。

额外问题：Bootstrap的active类规范 #

Bootstrap导航栏的active类默认是加在li.nav-item上，而非a.nav-link，直接给a标签加类可能无法触发正确的样式。

修正方案 #

1. 用PHP实现页面跳转后保留active状态
   直接在渲染导航时通过PHP判断当前页面，动态添加active类，页面加载时就有正确状态，无需依赖JS：

   // About Us项示例
   <li class="nav-item <?php echo ($pageTitle == 'About Us') ? 'active' : ''; ?>" id="navigation-about">
       <a class="nav-link" href="about.php">About Us</a>
   </li>
   
   // FAQ项示例
   <li class="nav-item <?php echo ($pageTitle == 'FAQ') ? 'active' : ''; ?>" id="navigation-faq">
       <a class="nav-link" href="faq.php">FAQ</a>
   </li>
   
   // 首页判断示例
   <li class="nav-item <?php echo basename($_SERVER['PHP_SELF']) == 'index.php' ? 'active' : ''; ?>">
       <a class="nav-link" href="index.php">Home</a>
   </li>
   

2. 修正JS文件路径
   把footer里的JS引用改成绝对路径（开头加斜杠，指向网站根目录）：

   <script src="/js/class-active.js"></script>
   

   如果网站部署在子目录（比如localhost/php-site/），则路径改为/php-site/js/class-active.js。

3. 优化JS代码（针对锚点链接）
   如果需要保留JS处理锚点跳转（比如href="#"的菜单），修改JS为操作nav-item：

   $(document).ready(function() {
       $('.nav-item a').on('click', function(e) {
           if ($(this).attr('href') === '#') {
               e.preventDefault();
               $('.nav-item').removeClass('active');
               $(this).closest('.nav-item').addClass('active');
           }
       });
   });
   

内容的提问来源于stack exchange，提问作者SamberJac